CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

git-value-scrubbing

This skill should be used when the user asks to "scrub JSON values", "mask config fields", "add a Git clean filter", "remove volatile values from tracked config", or "stop config churn".

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exceptionally actionable, well-sequenced operational skill: complete script templates, executable jq code, and an unusually thorough verification section with feedback loops and safety rails for the risky staging/renormalize steps. Its only real costs are minor repetition of the staging-safety rule and a verification section long enough that it could be split into a reference file.

DimensionReasoningScore

Conciseness

The body is dense and operational — script template, jq walk() example, exact git commands — with no padding explaining generic concepts; the repo-specific data-flow note ("smudge side of the filter is always `cat`") is genuinely non-obvious. Minor trimmable repetition exists: the staging-safety rule appears in "Wiring it in" step 4, again in the verification checklist, and again in "Explicit prohibitions". This fits anchor 4 (efficient with minor over-explanation), not 5, and is well above anchor 3.

4 / 5

Actionability

Fully concrete guidance: a complete bash script template with header-comment format, an executable `walk(...)`/`with_entries(...)` jq program for nested keys, and exact verification commands (`git check-attr filter -- <path>`, `git hash-object --path=<path>`, `git rev-parse :'<path>'`). Placeholders like `<name>`/`<path>` are appropriate parameterization for a convention-template skill, matching the copy-paste-ready top anchor.

5 / 5

Workflow Clarity

A clear sequence — inspect convention, choose sentinel vs. deletion, implement script, wire in (numbered), verify — backed by an 8-item verification checklist and explicit feedback loops ("If a live runtime check shows a chosen sentinel is rejected... switch that one field to deletion... and re-verify"). The risky batch operation (renormalize/staging) is heavily validated, matching the top anchor with explicit checkpoints and error-recovery guidance.

5 / 5

Progressive Disclosure

A single self-contained SKILL.md with clear, well-ordered section headers and no bundle files; the only file references (`scripts/mask-codex-state.sh`, `justfile`) are to the target repo's convention, not bundle content. At ~158 lines it exceeds the under-50-lines simple-skill exception, and the long verification checklist is the one block that could plausibly live in a separate reference file — good structure with minor organization gaps, i.e. anchor 4 rather than 5.

4 / 5

Total

18

/

20

Passed

Description

81%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A trigger-first description with excellent, natural trigger phrases and a clearly distinct niche. Its main weakness is the absence of an explicit capability statement, leaving the 'what' implied by the trigger phrases rather than directly stated.

Suggestions

Lead with a direct third-person capability statement (e.g. "Scrubs volatile or secret values from a tracked config file's committed blob using git clean filters, leaving the on-disk file untouched") before the 'Use when...' clause.

Fold the existing trigger phrases into a compact 'Use when...' sentence so both 'what' and 'when' read as explicit, parallel statements.

DimensionReasoningScore

Specificity

The description names a concrete domain through quoted operations like "scrub JSON values" and "add a Git clean filter", but never states what the skill itself does — the actions appear only as user-side trigger phrases. It exceeds anchor 2 (domain is specific, not generic) but falls short of anchor 4, which expects the skill's concrete actions to be listed as capabilities.

3 / 5

Completeness

The 'when' is fully explicit ("This skill should be used when the user asks to..."), and the 'what' is conveyed through the concrete trigger operations, but there is no direct capability statement (e.g. "Scrubs volatile values from committed config blobs using git clean filters"). Both are present as in anchor 4, though the 'what' relies on implication from the triggers rather than an explicit statement, keeping it below anchor 5.

4 / 5

Trigger Term Quality

Five natural, quotable trigger phrases — "scrub JSON values", "mask config fields", "add a Git clean filter", "remove volatile values from tracked config", "stop config churn" — cover synonym variations a user would genuinely say. This matches the anchor for comprehensive natural-term coverage.

5 / 5

Distinctiveness Conflict Risk

The niche — git clean filters for scrubbing tracked config values — is highly specific with distinct trigger phrases ("stop config churn", "add a Git clean filter") that are unlikely to fire for any other skill. This is a clear niche with minimal conflict risk, matching the top anchor.

5 / 5

Total

17

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 4 missing

Warning

Total

15

/

16

Passed

Repository

phatblat/dotfiles

Path

.agents/skills/git-value-scrubbing/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.