Content
42%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 generic template: tautological trigger sections, an opening that duplicates the description, abstract instructions, and a broken reference to a missing playbook file. It is structured but lacks any concrete, executable technical guidance.
Suggestions
Replace the abstract Instructions with concrete, executable steps for AI-assistant development (e.g., defining intents, designing context/memory, wiring tool-calling, configuring guardrails) with real code or config examples.
Create the referenced 'resources/implementation-playbook.md' (and resources/ directory) or remove the broken reference so progressive disclosure points to real material.
Delete the tautological 'Do not use this skill when' bullets and the duplicated opening paragraph to tighten conciseness.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short, but the opening paragraph duplicates the description, the 'Use this skill when'/'Do not use this skill when' bullets are tautological restatements of the skill name, and the Context section restates the description — efficient enough but padded with non-informative content that could be tightened. | 3 / 5 |
Actionability | Instructions are high-level hints with no concrete guidance ('Clarify goals, constraints, and required inputs', 'Apply relevant best practices and validate outcomes') — no code, commands, schemas, or specific steps to execute. | 2 / 5 |
Workflow Clarity | A rough sequence is implied (clarify → apply best practices → validate → provide steps + verification) and validation is mentioned, but checkpoints are implicit and the steps are generic rather than a concrete multi-step workflow. | 3 / 5 |
Progressive Disclosure | Sections are well-organized and a reference is signaled, but the only referenced file ('resources/implementation-playbook.md') does not exist — no resources/ directory is present — so the reference is broken, undercutting navigation. | 3 / 5 |
Total | 11 / 20 Passed |