Content
85%Reviews 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 lifecycle skill with strong validation checkpoints and clean one-level-deep reference navigation. Its main weakness is repetition — several critical warnings are stated multiple times and the opening injection block is verbose.
Suggestions
Consolidate the repeated `--no-prompt`/`Error: EOF` guidance and the 'run foundry commands from the app root / cd back' rule into one stated-once section; reference it instead of restating in Step 4, Step 5, Step 7, and the top injection block.
Trim the all-caps 'SYSTEM INJECTION — READ THIS FIRST' block; fold its non-delegation rule into the existing Decision Tree or a single concise note, since the description already carries the trigger/non-trigger scoping.
Move the multi-cloud ID-stripping and e2e local-test recipes (which are situational) into a reference file, keeping SKILL.md focused on the core creation flow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and full of domain-specific CLI detail Claude would not know, but it repeats several warnings (the `--no-prompt`/`Error: EOF` note and the 'cd back to app root' rule each appear multiple times) and opens with a verbose, all-caps 'SYSTEM INJECTION' block that could be tightened. | 2 / 3 |
Actionability | Provides fully executable, copy-paste-ready commands throughout — `foundry apps create --name ... --no-prompt --no-git`, the capability scaffolding sequence, `yq` ID-stripping, and `npm install && npm run build` — with concrete flags and paths. | 3 / 3 |
Workflow Clarity | The App Creation Flow is a clearly sequenced Steps 1–7 with an explicit validation checkpoint ('VALIDATE EARLY — fail fast if specs or schemas are bad', 'If validation fails, STOP. Fix the spec/schema') and feedback loops, matching the strong anchor. | 3 / 3 |
Progressive Disclosure | The body is an overview with a 'Reading Guide' table signaling five one-level-deep references (headless-operation, superpowers-integration, performance-optimization, counter-rationalizations, advanced-patterns), all of which exist as real files in references/. | 3 / 3 |
Total | 11 / 12 Passed |