Author structured Shared Context Engineering implementation plans.
93
93%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that hits all the key criteria. It provides specific concrete actions, comprehensive trigger terms covering natural user language, explicit 'Use when' guidance with multiple scenarios, and a distinctive niche tied to the SCE framework and specific file output format. The description is concise yet thorough, using proper third-person voice throughout.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: creates/updates structured plans, breaks change requests into scoped atomic tasks, specifies clear goals, boundaries, acceptance criteria, and verification steps. Also specifies the output path format `context/plans/{plan_name}.md`. | 3 / 3 |
Completeness | Clearly answers both 'what' (creates structured implementation plans with atomic tasks, goals, boundaries, acceptance criteria, verification steps) and 'when' with an explicit 'Use when...' clause covering multiple trigger scenarios (planning features, refactors, integrations, needing task breakdowns or roadmaps). | 3 / 3 |
Trigger Term Quality | Includes a strong set of natural keywords users would say: 'plan a new feature', 'refactor', 'integration', 'project plan', 'task breakdown', 'implementation roadmap', 'work plan', 'structured planning', 'change request', 'success criteria'. These cover many natural variations of how users would request planning help. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with the specific SCE framework reference, the output path `context/plans/{plan_name}.md`, and the focus on structured implementation planning with acceptance criteria. This is clearly distinguishable from general coding skills, documentation skills, or project management skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
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-structured planning skill with strong actionability and clear workflow sequencing. The clarification gate as a blocking checkpoint and the atomic task slicing contract are particularly strong design choices. Minor weaknesses include some redundancy between the skeleton and filled-in examples inline, and the referenced PLAN_EXAMPLE.md is not provided in the bundle, making progressive disclosure harder to fully evaluate.
Suggestions
Provide the referenced `context/plans/PLAN_EXAMPLE.md` bundle file so the full annotated reference plan is actually available, and consider moving the inline skeleton + filled-in example into that file to reduce SKILL.md length.
Consolidate the example task skeleton and the filled-in example into a single filled-in example to reduce redundancy while preserving clarity.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient and avoids explaining concepts Claude already knows. However, some sections are slightly verbose—the clarification gate's bullet list of critical details is thorough but could be tightened, and the example clarification questions, while useful, add length. The example task entries are valuable but the skeleton + filled-in example is somewhat redundant. | 2 / 3 |
Actionability | The skill provides highly concrete, actionable guidance: specific plan format, required task fields, a filled-in example task with real commands (`pnpm test`, `curl`), checkbox syntax for progress tracking, exact output path (`context/plans/{plan_name}.md`), and a canonical next command (`/next-task {plan_name} T01`). Very little is left ambiguous. | 3 / 3 |
Workflow Clarity | The workflow is clearly sequenced: intake trigger → clarification gate (blocking) → plan writing → output contract. The clarification gate is an explicit validation checkpoint that blocks progress until ambiguities are resolved. The atomic task slicing contract provides clear rules for splitting work. The required final validation task and output contract close the loop well. | 3 / 3 |
Progressive Disclosure | The skill references `context/plans/PLAN_EXAMPLE.md` for a full annotated reference plan, which is good progressive disclosure. However, no bundle files were provided, so this reference is unverifiable. The main content is reasonably well-structured with clear sections, but the inline examples (skeleton + filled-in task) could potentially be offloaded to the referenced example file to keep the SKILL.md leaner. | 2 / 3 |
Total | 10 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
Reviewed
Table of Contents