Content
43%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 SKILL.md body is a thin, well-intentioned overview that delegates essentially all substance to the detailed guide, but it provides no executable workflow in the body itself and the delegated references contain broken file and script links.
Suggestions
Add a minimal executable quick-start (e.g. the quick_scan.py / full_audit.py invocation with a relative path and a validation/verify step) directly in SKILL.md so the body is actionable without loading the guide.
Fix broken references: remove or create the five missing reference files (hardening-linux.md, hardening-windows.md, payment-security.md, bot-security.md, compliance-matrix.md) and the missing scripts (threat_modeler.py, security_checklist.py, surface_mapper.py, hardening_advisor.py) referenced in detailed-guide.md.
Replace Windows absolute paths (C:\Users\renat\skills\007\scripts\...) with portable relative paths (e.g. python scripts/quick_scan.py --target <path>) and add an explicit validate-then-proceed checkpoint for destructive or batch operations.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean, assumes Claude's intelligence, and avoids explaining concepts Claude already knows, though phrases like 'Treat its safety, prerequisites, and validation requirements as mandatory' are slightly redundant given 'Read ... before executing'. | 4 / 5 |
Actionability | The body offers only high-level direction ('Read the detailed guide before executing this skill') with no concrete commands or steps in SKILL.md itself, leaving the executable guidance delegated and unspecified. | 2 / 5 |
Workflow Clarity | No multi-step sequence or validation checkpoints appear in the body; the Limitations section's 'Stop and ask for clarification' is a weak checkpoint, but for a destructive/batch-capable audit skill the missing validation caps this low. | 2 / 5 |
Progressive Disclosure | There is a clearly signaled one-level-deep reference to references/detailed-guide.md, but that guide points to five reference files (hardening-linux, hardening-windows, payment-security, bot-security, compliance-matrix) and several scripts (threat_modeler.py, security_checklist.py, surface_mapper.py, hardening_advisor.py) that do not exist, and uses non-portable Windows absolute paths, breaking navigation. | 3 / 5 |
Total | 11 / 20 Passed |