Content
46%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 well-structured with a clear kickoff workflow and explicit authorization checkpoints, but it is a pointer document whose two referenced files are missing from the bundle — the actual research workflow and report template it depends on are absent, making the skill unexecutable as shipped. Repetition of the approval rules across four sections also inflates the token cost.
Suggestions
Ship the referenced files: create reference/research-workflow.md (with the Phase 1-6 workflow) and reference/report-template.html, or inline a minimal version of the workflow if the bundle is meant to be single-file.
Consolidate the authorization rules into the Interaction Rules section and reference them once from the Non-Negotiable Rules, the deepening section, and the pseudoflow to remove the quadruple repetition.
Inline a brief outline of the post-approval research phases (even 5-6 bullet lines) so the core sequence survives even when the external workflow file is unavailable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body avoids explaining known concepts and is sectioned, but the authorization/non-approval logic is repeated four times (Non-Negotiable Rules, Interaction Rules items 4-7, the deepening section, and the pseudoflow), and the pseudoflow restates the Step 1-4 sequence verbatim. Mostly efficient but could be tightened by stating the authorization rules once, which keeps it below 4. | 3 / 5 |
Actionability | The kickoff phase is genuinely concrete ('Run one web_search call with 2-3 queries in parallel... (e.g. "what is X" + "X current debates" + "X use cases")', exact ask_user question structure, timeout policy), but the execution phase is entirely delegated to 'reference/research-workflow.md' and the deliverable to 'reference/report-template.html' — neither file exists in the bundle, so 'execute full workflow' and 'follow template rules' cannot actually be executed. Some concrete, incomplete guidance matches the 3 anchor rather than 4. | 3 / 5 |
Workflow Clarity | The pre-execution sequence (pre-search -> plan draft -> ask_user kickoff -> continue from answer) is clearly ordered with explicit authorization checkpoints, and the deepening mode has its own flow. However, the sequence after approval is a black box ('execute full workflow', 'Phase 6's gap diagnosis') pointing at a missing reference file, leaving key steps undefined — a present-but-gapped sequence, hence 3 rather than 4. | 3 / 5 |
Progressive Disclosure | The 'References (Read On Demand)' section is well designed — two files, one level deep, each mapped to a condition — but neither 'reference/research-workflow.md' nor 'reference/report-template.html' exists in the bundle (no reference/, references/, scripts/, or assets/ directories are present). Scored against the actual bundle structure, both referenced paths are dead, so the on-demand content the whole skill depends on is undeliverable; the signaling is good but the disclosure chain is broken, which lands at 2 rather than 3. | 2 / 5 |
Total | 11 / 20 Passed |