Content
82%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 strong, highly actionable skill: the exact YAML format, concrete commands, and named MCP tools leave nothing abstract. The main improvements are cosmetic (a malformed header, a stray horizontal rule) and removing a couple of duplicated emphasis lines.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with executable templates, exact bash commands, and precise MCP tool names, with no explanations of concepts Claude already knows. Minor over-explanation could be trimmed: the requirement that goal:/now: be named exactly is stated twice ('The statusline parser looks for EXACTLY goal: and now: - nothing else works' duplicates the earlier 'they MUST be named exactly this'), and the 'IMPORTANT: Replace {session_name}...' note restates placeholders already shown in the parameters. | 4 / 5 |
Actionability | Fully executable guidance throughout: copy-paste bash commands for the session-name fallback chain, an exact YAML template with concrete example file paths, the exact MCP tool names (mcp__opc-memory__index_artifacts, mcp__opc-memory__mark_handoff) with parameter blocks, and a ready-to-use confirmation message. It is not 4 because no concrete step requires the reader to fill in significant gaps; the only placeholders are inherently data-dependent. | 5 / 5 |
Workflow Clarity | Four clearly sequenced steps (filepath/metadata, write YAML, mark outcome, confirm) with an explicit outcome decision tree (blockers/questions -> SUCCEEDED/PARTIAL_PLUS/ask user) and cross-validation of now: against done_this_session:. Not 5 because checkpoints are missing in places: no guidance if an MCP call fails, and the outcome value to pass for the non-prompt default cases is only implied via the '<USER_CHOICE>' placeholder. | 4 / 5 |
Progressive Disclosure | For a single-purpose, self-contained skill the content is appropriately placed in four numbered sections plus a short notes section, with the bulk being the essential template. Minor organization gaps: the '##. Additional Notes & Instructions' header at line 164 is invalid markdown heading syntax, and the stray '---' at line 106 renders as a rule mid-section; these slightly hurt navigation but structure is otherwise good. | 4 / 5 |
Total | 17 / 20 Passed |