Home / Reports / planning-with-files

planning-with-files

Validated 11 Oct 2026 · Repository
Pro
61/ 100Needs Work
0 critical
6 warnings
9 suggestions
112 checks passed

Domain scores

Anti-Slop
80
Accessibility
100
Enterprise
100

Issues

Warnings (6)

5.1-no-style-sectionline 1
No writing style section found
Fix: Add a '## Writing Style' or '## Anti-Slop' section
2.5-windows-pathline 62
Windows-style path with backslashes detected
Fix: Use forward slashes for cross-platform compatibility: scripts/helper.py
19.4-inversion-no-questionsline 34
Inversion pattern detected but no question framework documented
Fix: Document what questions the skill asks and when it stops asking
1.2-desc-whatline 3
Description missing WHAT clause (action verb) - recommended by agentskills spec
Fix: Consider starting with what the skill does, e.g., 'Creates...', 'Generates...', 'Validates...'
9.1-fm-tokensline 1
Frontmatter exceeds 400 token budget (estimated 412)
Fix: Shorten description or move details to body
9.2-body-tokens-warningline 34
Body exceeds 5000 token optimal budget (estimated 6983)
Fix: Consider condensing or using references

Suggestions (9)

5.2-no-do-dontline 1
Missing DO/DON'T lists for style guidance
Fix: Add explicit DO and DON'T lists for writing patterns
16.4-no-idempotencyline 34
Skill does not document whether it is safe to re-run
Fix: Add idempotency guidance: state whether running the skill twice produces the same result or causes side effects
17.4-no-interface-sectionline 34
Input and output contracts exist but lack a dedicated interface section
Fix: Add a ## Interface or ## I/O section to consolidate contract documentation
18.1-no-confidence-signalline 1
No confidence signal found for orchestrator decision-making
Fix: Add confidence indicators (e.g., confidence: high/medium/low) so orchestrators can route or retry
4.2-ambiguous-termline 259
Ambiguous term 'several' found
Fix: Replace with specific, measurable criteria
4.2-ambiguous-termline 273
Ambiguous term 'several' found
Fix: Replace with specific, measurable criteria
1.19-non-portable-fieldline 6
Frontmatter keys outside the agentskills spec: hooks, user-invocable. Claude Code loads the skill with them; claude.ai uploads and the Skills API reject it with 'Unexpected key(s)'
Fix: Nothing to do for Claude Code or plugin distribution. To upload to claude.ai or the Skills API, ship frontmatter with only name, description, license, compatibility, metadata and allowed-tools
9.4-reference-countline 1
High number of external references (12)
Fix: Consider consolidating references
9.5-desc-tokensline 3
Description is 107 tokens; aim for under 100
Fix: Make description more concise

OWASP Agentic (Cat 26)

Agent surface detected: declares tool beyond Read/Glob/Grep: Read Write Edit Bash Glob Grep; ingests external content; performs consequential actions
No deterministic OWASP signals on this agent surface.
ASI-01: passASI-02: skippedASI-03: skippedASI-04: skippedASI-05: skippedASI-06: passASI-07: skippedASI-08: skippedASI-09: skippedASI-10: skippedASI-11: skipped

Badges

skillcheck ✕ passed skillcheck ✕ antislop 100 skillcheck WCAG AA skillcheck WCAG AAA skillcheck enterprise

Get a report like this for your own skill

Run the free validator to see your score in seconds. Pro adds the substance checks: anti-slop, security, accessibility and agent readiness.