Content
70%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.
The body is a well-structured, validated multi-step workflow with concrete, actionable guidance for an MCP-driven Notion/Linear/GitHub process. Its main weakness is that the referenced bundle files (SRED.md, project-template.md) do not actually exist, breaking progressive disclosure.
Suggestions
Add the missing `references/SRED.md` and `references/project-template.md` bundle files so the referenced paths resolve.
De-duplicate the uncertainty-length constraint (stated in both Step 4 and Step 5) and consolidate the repeated user-review checkpoints.
Name the specific MCP tools or `gh` commands expected (e.g. which Notion MCP tool creates a child page) to close the small actionability gap.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient for a complex workflow, but it repeats constraints (the "only a few sentences long" uncertainty-length rule appears in both Step 4 and Step 5) and reiterates the user-review checkpoint at multiple sub-steps, which could be tightened. | 3 / 5 |
Actionability | Guidance is concrete and specific — exact Notion document names ("SRED Project Summary - <year> <project name>"), named sections to fill, explicit 100-word limits, and a referenced template — leaving only minor gaps around the actual MCP tool invocations. | 4 / 5 |
Workflow Clarity | The process is clearly sequenced (Step 1-6 with Step 5 sub-steps 1-8) and includes explicit validation via "Ensure:" checklists, user review checkpoints, and a feedback loop ("Make any changes they ask for"), satisfying the batch-operation validation requirement. | 5 / 5 |
Progressive Disclosure | References to `${CLAUDE_SKILL_ROOT}/references/SRED.md` and `project-template.md` are clearly signaled and one level deep, but the `references/` directory does not exist, so the referenced bundle files are missing and navigation dead-ends. | 3 / 5 |
Total | 15 / 20 Passed |