Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured, highly actionable skill with clear workflows and validation checkpoints. Its main weakness is verbosity—several sections repeat information or include content that would be better placed in reference files. The security-focused workflow with explicit blocking on secret detection is well-designed.
Suggestions
Move 'Detected Secret Types', 'Common False Positives', and 'Post-Exposure Actions' to reference files to reduce the main SKILL.md length and improve progressive disclosure.
Remove the 'Integration with Repomix' section as it duplicates the Options section almost entirely.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably well-structured but includes some redundancy—the 'Integration with Repomix' section largely repeats the Options section, and the example workflows partially duplicate earlier content. The 'Post-Exposure Actions' and 'Common False Positives' sections, while useful, add bulk that could be trimmed or moved to a reference file. | 2 / 3 |
Actionability | The skill provides concrete, copy-paste-ready commands throughout, with specific CLI invocations, clear before/after code examples for credential replacement, and explicit output examples showing what to expect. Every step is executable. | 3 / 3 |
Workflow Clarity | The core workflow is clearly sequenced (scan → report → block/pack) with explicit validation checkpoints. The 'Handling Detected Secrets' section has a clear 5-step process with a verify-cleanup step before proceeding. The tool itself enforces a feedback loop by blocking packaging when secrets are found. | 3 / 3 |
Progressive Disclosure | The skill references `references/common_secrets.md` and script files appropriately, but the main document is quite long (~200+ lines) with sections like 'Post-Exposure Actions', 'Common False Positives', and 'Detected Secret Types' that could be moved to reference files. The Resources section provides clear navigation but the body contains too much inline detail. | 2 / 3 |
Total | 10 / 12 Passed |