skill-creator — SkillCheck Report

Issues

Warnings (10)

16.1-no-stop-condition Complex skill lacks explicit stop conditions line 6
Fix: Add stop/termination criteria (e.g., 'Stop after N iterations', 'Abort if error rate exceeds threshold')
15.1-no-budget-cap Multi-agent skill has no budget or turn cap; runaway costs are possible line 6
Fix: Add max_turns, cost_limit, or similar budget constraint for subagents
19.2-reviewer-no-criteria Reviewer pattern detected but no evaluation criteria documented line 6
Fix: Add a criteria section (checklist, rubric, or pass/fail conditions)
19.3-generator-no-output-spec Generator pattern detected but no output format specified line 6
Fix: Document the output format (template, schema, or example output)
13.1-dangling-reference File reference does not exist on disk: /tmp/eval_review_ line 369
Fix: Verify the path or remove the stale reference
13.1-dangling-reference File reference does not exist on disk: .skill line 410
Fix: Verify the path or remove the stale reference
13.1-dangling-reference File reference does not exist on disk: .docx line 426
Fix: Verify the path or remove the stale reference
13.1-dangling-reference File reference does not exist on disk: .xlsx line 426
Fix: Verify the path or remove the stale reference
7.7-task-ambiguity Ambiguous instruction detected (subjective-quality) line 294
Fix: Add measurable criteria (e.g., 'reduce to <20 lines', 'under 100ms')
9.2-body-tokens-warning Body exceeds 5000 token optimal budget (estimated 6696) line 6
Fix: Consider condensing or using references

Suggestions (22)

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
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
4.2-ambiguous-term Ambiguous term 'few' found line 14
Fix: Replace with specific, measurable criteria
4.2-ambiguous-term Ambiguous term 'some' found line 16
Fix: Replace with specific, measurable criteria
4.2-ambiguous-term Ambiguous term 'some' found line 36
Fix: Replace with specific, measurable criteria
4.2-ambiguous-term Ambiguous term 'appropriate' found line 54
Fix: Replace with specific, measurable criteria
4.2-ambiguous-term Ambiguous term 'few' found line 143
Fix: Replace with specific, measurable criteria
4.2-ambiguous-term Ambiguous term 'good' found line 203
Fix: Replace with specific, measurable criteria
4.2-ambiguous-term Ambiguous term 'good' found line 320
Fix: Replace with specific, measurable criteria
4.2-ambiguous-term Ambiguous term 'good' found line 352
Fix: Replace with specific, measurable criteria
4.2-ambiguous-term Ambiguous term 'some' found line 354
Fix: Replace with specific, measurable criteria
4.2-ambiguous-term Ambiguous term 'appropriate' found line 356
Fix: Replace with specific, measurable criteria
4.2-ambiguous-term Ambiguous term 'some' found line 377
Fix: Replace with specific, measurable criteria
4.2-ambiguous-term Ambiguous term 'some' found line 422
Fix: Replace with specific, measurable criteria
4.2-ambiguous-term Ambiguous term 'good' found line 454
Fix: Replace with specific, measurable criteria
4.2-ambiguous-term Ambiguous term 'good' found line 485
Fix: Replace with specific, measurable criteria
4.3-output-format Skill mentions output but doesn't specify format line 1
Fix: Add an '## Output' section with format examples
12.4-no-troubleshooting Complex technical skill lacks troubleshooting section line 6
Fix: Add a ## Troubleshooting section with Error/Cause/Fix table for common issues
12.6-unbounded-iteration Potential unbounded iteration 'For each test': Claude may silently shortcut with many items line 171
Fix: Combine patterns into a single query, or batch into groups of 10-20 items