Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A highly actionable, well-sequenced security workflow with explicit checkpoints and concrete patterns. Its weaknesses are token efficiency from repeated framework/false-positive lists across the body and subagent prompts, and a lack of progressive disclosure for a skill of this length.
Suggestions
De-duplicate the frontend/backend and false-positive lists: define them once in the body and have the Phase 1 and Phase 2 subagent prompts reference that single source (or pass the relevant excerpt) instead of restating each list verbatim.
Extract the large secret-pattern reference table and/or the full subagent prompt templates into a bundled reference file (e.g. references/secret-patterns.md) linked from SKILL.md, so the main file stays a lean overview with one-level-deep navigation.
Tighten the opening "What Are Hardcoded Secrets" prose to assume Claude's existing knowledge of what a hardcoded secret is, leading directly into the public-accessibility distinction that is the skill's actual focus.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and concrete, but the framework public/not-public lists recur three times ("What to Report"/"What NOT to Report", "Distinguishing Frontend from Backend", and again inside the Phase 2 subagent prompt), and the false-positive/placeholder lists are likewise repeated across the body and both subagent prompts. The opening also restates what hardcoded secrets are. | 2 / 3 |
Actionability | Provides concrete, copy-paste-ready guidance: exact regex patterns per secret type, named variable patterns, fully specified subagent prompts, and precise output-file templates with field-by-field formats. | 3 / 3 |
Workflow Clarity | The three phases are clearly sequenced with an explicit validation gate ("If the recon found zero candidates... skip Phase 2 and Phase 3"), a detailed parallel batching procedure, ordered cleanup of intermediate files only after the final report is written, and a closing "Important Reminders" checklist. | 3 / 3 |
Progressive Disclosure | Well-organized into sections, but the skill is a ~395-line monolith with no bundle files of its own; the large inline secret-pattern table and the full Phase 1/Phase 2 subagent prompt templates are content that could be split into one-level-deep reference files rather than carried inline. | 2 / 3 |
Total | 10 / 12 Passed |