Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-crafted skill with excellent actionability and workflow clarity. The multi-step process is clearly sequenced with explicit decision points, fallbacks, and validation criteria. The main weaknesses are moderate verbosity (philosophical framing and repeated principles) and a somewhat monolithic structure that could benefit from extracting detailed sub-workflows to reference files.
Suggestions
Remove or condense the introductory paragraph and 'Muse's Principles' section - these concepts are already embedded in the workflow steps
Consider extracting Step 6 (Go Deeper) sub-steps to a separate reference file like 'references/topic-refinement.md' to reduce main file length
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is well-written but includes some unnecessary prose and philosophical framing ('Your muse knows what you've been thinking about...', 'The output is not a plan. It's a direction.'). The principles section at the end repeats concepts already clear from the workflow. Could be tightened by ~20%. | 2 / 3 |
Actionability | Provides fully executable curl commands for Signal DB queries, concrete bash commands for file checks, specific query patterns for web searches, and detailed output formats. The guidance is copy-paste ready with clear variable substitution patterns. | 3 / 3 |
Workflow Clarity | Seven clearly sequenced steps with explicit decision points (EXTEND.md found/not found, Signal DB enabled/disabled, content paths empty). Includes validation checkpoints ('When to move on' criteria in Step 6), fallback behaviors, and clear hand-off conditions. The workflow handles edge cases explicitly. | 3 / 3 |
Progressive Disclosure | References external files appropriately (EXTEND.md, first-time-setup.md) but the main skill file is quite long (~200 lines). Step 6's sub-steps could potentially be extracted to a separate reference. The structure is good but the content density in a single file is high. | 2 / 3 |
Total | 10 / 12 Passed |