Content
85%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.
A highly actionable, well-sequenced skill with strong validation checkpoints and clean one-level-deep progressive disclosure to real bundle files. The main weakness is repetition across the injection banner and MUST/MUST NOT guardrails that inflates token cost without adding information.
Suggestions
Consolidate the repeated CRITICAL/MUST NOT guardrails (cwd requirement, --no-prompt, no-mkdir, no manual manifest edits) into one authoritative section and reference it instead of restating each multiple times.
Trim the ALL-CAPS SYSTEM INJECTION banner to the essential routing rule; the detail it previews is repeated verbatim later in the body.
Move the counter-rationalization framing out of the hot path and rely on the dedicated counter-rationalizations.md reference, keeping the body focused on instructions.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with executable commands and tables, but the SYSTEM INJECTION banner, repeated CRITICAL warnings, counter-rationalizations references, and restated guardrails ('MUST NOT edit manifest.yml', 'MUST NOT fall back to mkdir') reappear multiple times, adding padding a tighter version could trim. It is above the verbose score-2 anchor but carries enough repetition to sit below the lean score-4/5 anchors. | 3 / 5 |
Actionability | Fully executable, copy-paste-ready CLI commands with flags (e.g. 'foundry apps create --name "app-name" --description "description" --no-prompt --no-git') plus concrete tables mapping user phrases to commands, matching the score-5 anchor of copy-paste-ready guidance covering common cases. | 5 / 5 |
Workflow Clarity | A clearly sequenced 7-step App Creation Flow with an explicit early validation checkpoint ('VALIDATE EARLY — fail fast'), feedback loops ('If validation fails, STOP. Fix the spec/schema'), and recovery guidance for headless/connection failures, matching the score-5 anchor including feedback loops for destructive/batch operations. | 5 / 5 |
Progressive Disclosure | SKILL.md is a concise overview with a Reading Guide table pointing one level deep to real reference files (headless-operation.md, superpowers-integration.md, performance-optimization.md, counter-rationalizations.md, advanced-patterns.md, all present in ./references/), plus a detect_fusion_redirect.py script, with content appropriately split and easy to navigate, matching the score-5 anchor. | 5 / 5 |
Total | 18 / 20 Passed |