Content
81%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 an unusually well-engineered process skill: fully actionable numbered workflows with explicit captain-signature validation gates, concrete formats and templates, and clean section structure. Its one real cost is token efficiency — repeated contract statements and metaphor-heavy prose inflate the always-loaded body, and two specialized edge-case blocks (migration, legacy glossary) belong in reference files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with substantive, project-specific rules and explains nothing Claude would already know, but it could be meaningfully tightened: the tracker-only-medium rule is restated across 'Map home', the migration paragraph, and 'Scope and non-goals'; 'decisions, never deliverables' and 'one ticket per session' are each repeated several times; and the nautical framing plus long compound sentences add tokens without adding rules. More than the 'minor instances' of anchor 4, but far from the padded filler of anchor 2. | 3 / 5 |
Actionability | For an instruction-only skill the guidance is fully concrete: two numbered procedures with unambiguous steps, a copy-paste-ready map body template, a ticket-type table giving the exact resolution mechanism per type ('Call the Skill tool with "deep-interview"', 'spawn a background subagent', 'Call the Skill tool with "loft"'), an exact index-line format ('[<ticket title>](link): <one-line gist>'), a named command ('node scripts/shipyard-audit.mjs'), and verbatim exit and session-close phrasings. The common charting, working, and exit cases are all covered specifically. | 5 / 5 |
Workflow Clarity | Both multi-step processes are clearly sequenced, and validation checkpoints are explicit: the fog test (Q1/Q2) gates entry, W1 and W2 are captain signatures ('present the destination statement and get explicit confirmation', 'iterate until signed'), the migration path requires 'verify every decision, resolution, and dependency is represented before declaring the import complete', and claiming-before-work plus close-as-not-planned rules handle concurrency and out-of-scope tickets. Feedback loops (re-interview rounds, iterate-until-signed, import verification) are present for the risky tracker operations. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent), so all content lives in SKILL.md, and it is well organized: clear section headers, a ticket-type table, and a fenced map-body template make navigation easy, and pointers to companion skills (deep-interview, loft, drydock, launch) are one level deep. It falls short of anchor 5 because two dense inline blocks — the one-time local-map migration paragraph and the legacy-yards (CONTEXT.md) sediment rules — are exactly the kind of specialized, rarely-needed detail that would earn its place in a separate reference file instead of the always-loaded body. | 4 / 5 |
Total | 17 / 20 Passed |