Content
63%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 well-engineered, highly actionable research procedure with clear phase sequencing and thoughtful conditional skip rules that respect token budgets at runtime. Its weaknesses are structural: duplicated Technology & Infrastructure requirements, persona/example padding, and large reference tables inlined in SKILL.md instead of split into a references/ bundle.
Suggestions
Move the manifest-to-ecosystem table, deployment/API/data-layer pattern tables, and the <examples> block into a references/ file (e.g., references/ecosystem-map.md), keeping SKILL.md as a lean overview with one-level-deep, clearly signaled links.
Delete the duplicate statement of Technology & Infrastructure section requirements (lines 170-178) — the Output Format template already specifies them — and fold the Core Responsibilities list into the scope table to remove the second enumeration of the same phases.
Drop the 'You are an expert repository research analyst...' persona paragraph and tighten abstract directives like 'Cross-reference discoveries across different sources' into concrete instructions (e.g., which sources to cross-check and how to report mismatches).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and mostly operational (skip rules, manifest tables) rather than explaining things Claude already knows, but there is real padding: the Technology & Infrastructure section requirements are stated twice (lines 170-178 and again in the Output Format template), Core Responsibilities duplicates the scope table's phase list, and the ~26-line <examples> block plus the 'You are an expert repository research analyst' persona intro add tokens without new instruction. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' — below anchor 4, well above anchor 2's padded profile. | 3 / 5 |
Actionability | Guidance is highly concrete for an instruction-only skill: exact globs ('a single glob of the repository root (`*`)', '`*/go.mod`'), a 16-row manifest-to-ecosystem table, explicit conditional skip rules, and a copy-ready output template. It falls short of anchor 5 only because some directives stay abstract ('Cross-reference discoveries across different sources', 'Prioritize official documentation over inferred patterns') and there is no worked example of a scoped invocation's output — matching 'mostly executable guidance; concrete code or commands with minor gaps' rather than the vague-guidance anchors 2-3. | 4 / 5 |
Workflow Clarity | Sequencing is explicit and well-gated: Phase 0 'Run First', 0.1 → 0.1b → 0.2 → 0.3 with 'Using Phase 0 Findings' bridging into the numbered Research Methodology, plus a scoping table that says exactly which phases run per scope. Checkpoints exist ('Verify findings by checking multiple sources', 'distinguish between official guidelines and observed patterns') but are stated as QA principles rather than inline validation steps in the flow, so it matches anchor 4 ('most checkpoints present; minor validation gaps') and not anchor 5's explicit validate-fix-retry loops. No destructive/batch operations, so no cap applies. | 4 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are all absent) and the SKILL.md is a single ~280-line document. Internal structure is good (headers, tables, clear sections), but reference-grade material — the manifest-to-ecosystem mapping, deployment/API/data-layer pattern tables, and the <examples> block — is inlined where a references/ file would keep the overview lean. This matches anchor 3 ('some structure but could be better organized; content that should be separate is inline') — better than anchor 2's structureless inline dump, short of anchor 4's well-split layout. | 3 / 5 |
Total | 14 / 20 Passed |