Content
71%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 well-structured, actionable instruction-only skill with a clear step sequence and concrete templates and checkpoints. Its main weaknesses are a duplicated output-format section and a dangling reference to docs/output-kit.md that has no corresponding file in the bundle.
Suggestions
Include docs/output-kit.md in the skill bundle (e.g., under references/) or inline the essential output-format rules directly in SKILL.md so the dangling reference resolves.
Clarify the external dependencies: where the pitch_agent.uiux module, pitch-position/pitch-message, and /atlas-report come from and what to do if they are unavailable.
Merge the Delivery section into Step 8 to remove the duplicated output-format guidance and tighten token usage.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean and skill-specific (headline rules like "Specific > vague ('Deploy APIs in 3 minutes' > 'Build faster')") with no padding or explanation of known concepts; the Delivery section slightly duplicates Step 8's output-format instructions, keeping it just short of the 5 anchor. | 4 / 5 |
Actionability | Provides concrete block skeletons for every section, a runnable command (python3 -m pitch_agent.uiux search...), a ranked proof taxonomy, and an exact placeholder format; minor gaps (e.g., the pitch_agent module's provenance is unstated) keep it below fully copy-paste-ready. | 4 / 5 |
Workflow Clarity | Eight clearly sequenced steps with real checkpoints ('If none of this is available, ask' and 'Flag any claim that needs evidence before going live'); not 5 because explicit error-recovery loops beyond asking for context are absent. No destructive/batch operations, so no cap applies. | 4 / 5 |
Progressive Disclosure | The body is well-sectioned but its single external reference — 'the output format defined in docs/output-kit.md' — dangles: no references/, scripts/, assets/, or docs/ files exist in the bundle, so the pointer cannot be resolved. | 3 / 5 |
Total | 15 / 20 Passed |