Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with executable detection patterns and a well-sequenced, validation-checked workflow. Its weaknesses are length-driven redundancy and a fully monolithic structure with no reference files, which cost it on conciseness and progressive disclosure.
Suggestions
De-duplicate overlapping content between the Phase 3 completeness table, the Phase 4 compound-finding matrix, and the Output Format checklist so each section earns its tokens and conciseness moves toward 3.
Split stable reference material (the full pattern catalog and the output template) into a reference file under references/ and link to it one level deep, improving progressive disclosure from 2 to 3.
Consider moving the long compound-finding and false-positive tables into a reference doc, keeping SKILL.md as a tight overview of the five phases plus the most critical patterns.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational with almost no conceptual padding, but at ~290 lines it carries redundancy — the Phase 3 question table, Phase 4 compound-finding matrix, and the Output Format's Privacy Manifest checklist restate overlapping material — so it could be tightened rather than earning a perfect 'every token earns its place'. | 2 / 3 |
Actionability | It supplies directly executable detection patterns (e.g., `AKIA[0-9A-Z]{16}`, `sk-[a-zA-Z0-9]{24,}`, `apiKey.*=.*"[^"]+"`), specific file globs, concrete Info.plist keys, and copy-paste-ready fixes like Keychain with `kSecAttrAccessibleWhenUnlockedThisDeviceOnly`. | 3 / 3 |
Workflow Clarity | A clear five-phase sequence (Map → Detect → Reason → Cross-Reference → Score) with explicit verification checkpoints ('use Read to verify the surrounding context before reporting', 'Require evidence from the Phase 1 map'), error-handling guidance (Output Limits), and checklists (Privacy Manifest Checklist, Security Posture table). | 3 / 3 |
Progressive Disclosure | No bundle files (references/scripts/assets) exist and the skill is a single ~290-line SKILL.md; content that could be split out — the long pattern catalog, the compound-finding matrix, and the full output template — is inline with no one-level-deep reference files to navigate to, so structure is good but disclosure is monolithic. | 2 / 3 |
Total | 10 / 12 Passed |