Content
15%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a thin, repetitive stub that restates the description three times and gives no executable guidance, workflow, or validation. It fails to add anything Claude does not already know about the topic.
Suggestions
Replace the repeated description with concrete, executable guidance: specific commands or code for loading/masking secrets and preventing them from reaching shells, logs, and git (e.g. a pre-commit hook or env-loading snippet).
Add a sequenced workflow with an explicit validation checkpoint (e.g. '1. load secret; 2. confirm it is not echoed; 3. run git diff --cached | grep -i <secret> before committing') to satisfy the destructive/batch validation requirement.
Collapse the Overview/When to Use/Instructions trio into one concise statement to remove the padding and raise conciseness.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The same phrase ('secrets are never exposed in claude sessions, terminals, logs, or git commits') is restated verbatim across Overview, When to Use, and Instructions, padding the body with repetition that adds no new information — noticeably verbose rather than the lean anchor 5. | 2 / 5 |
Actionability | The Instructions merely state the skill 'provides guidance and patterns' without any concrete commands, code, or specific steps, matching 'entirely vague or abstract; no concrete code or commands; only describes rather than instructs'. | 1 / 5 |
Workflow Clarity | No steps or sequence are given for secure env var handling or git-commit safety, and there are no validation checkpoints despite git commits being a destructive/batch context; this matches 'steps missing or incoherent; no sequence; no validation'. | 1 / 5 |
Progressive Disclosure | Section headers exist and an external repository link is provided, but the sections are near-empty and repetitive with no internal bundle structure; as a simple under-50-line skill this lands at 'some structure but could be better organized' rather than the clean 5. | 3 / 5 |
Total | 7 / 20 Passed |