-
5.2-no-do-dont
Missing DO/DON'T lists for style guidance
line 1
Fix: Add explicit DO and DON'T lists for writing patterns
-
16.3-no-rollback
State-modifying skill lacks rollback or recovery guidance
line 6
Fix: Add rollback instructions: how to undo changes if something goes wrong (e.g., git revert, backup/restore steps)
-
16.4-no-idempotency
Skill does not document whether it is safe to re-run
line 6
Fix: Add idempotency guidance: state whether running the skill twice produces the same result or causes side effects
-
17.4-no-interface-section
Input and output contracts exist but lack a dedicated interface section
line 6
Fix: Add a ## Interface or ## I/O section to consolidate contract documentation
-
14.3-no-binary-verdict
Skill has success criteria but no binary pass/fail language
line 1
Fix: Add explicit pass/fail indicators so evaluators reach the same verdict independently
-
3.4-gerund-naming
Skill name could use gerund form for clarity
line 2
Fix: Consider gerund-style names like 'processing-pdfs' or 'analyzing-logs' (per best practices)
-
18.1-no-confidence-signal
No confidence signal found for orchestrator decision-making
line 1
Fix: Add confidence indicators (e.g., confidence: high/medium/low) so orchestrators can route or retry
-
18.2-no-progress-signal
Complex skill lacks progress reporting checkpoints
line 1
Fix: Add progress signals (e.g., 'Step 2 of 5: validating input') for long-running workflows
-
4.3-output-format
Skill mentions output but doesn't specify format
line 1
Fix: Add an '## Output' section with format examples
-
9.4-reference-count
High number of external references (12)
line 1
Fix: Consider consolidating references