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.
A highly actionable, well-sequenced orchestration skill with explicit gates and executable commands at every step. Its main costs are token weight — the artifact-resolution rule repeated ~5× and a long inline report template — plus a few references pointing at files that don't ship in the bundle.
Suggestions
State the artifact-resolution requirement once (e.g. in the §4.55 Artifact Resolution Gate) and reference it by section number from the Non-Negotiables, §3, the report template, and Finish Criteria, cutting ~4 restatements.
Move the ~80-line report template in §7 into a reference file (e.g. references/report-template.md) and keep only the section headings and cleanup rules in SKILL.md.
Ship or prune dangling references: evals/side-by-side.md, ../deepline-gtm/SKILL.md, ../deepline-analytics/SKILL.md, and THIRD_PARTY_NOTICES.md are cited but not present in the bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient operational instruction (no explanations of concepts Claude already knows), but the artifact-resolution requirement is restated roughly five times (Non-Negotiables, §3, §4.55, the §7 report template, Finish Criteria) and an ~80-line report template is inlined, which is more than minor over-explanation. Not anchor 2 because the bulk is dense, non-padded domain guidance rather than several unnecessary explanations. | 3 / 5 |
Actionability | Guidance is fully executable throughout: copy-paste bash for install/auth/preflight ("deepline preflight --json"), tool searches with the required "DEEPLINE_SKIP_SELF_UPDATE=1" prefix, "deepline tools describe <tool-id> --json", a complete SKILL_ROOT discovery loop invoking "python3 "$SKILL_ROOT/scripts/query_design.py" "$OBJECTIVE" --depth default", and concrete curl examples for the planning API. Specific examples cover the common cases. | 5 / 5 |
Workflow Clarity | The Standard Flow is clearly sequenced (parse job → prefer APIs → public fanout → planning API → tool search → query design → coverage/artifact/consolidation gates → describe → probe → report → approval) with explicit validation checkpoints: preflight must complete standalone before fanout, the Coverage/Artifact Resolution gates must pass before recommending, and the Approval Gate requires an exact approval question before any paid run. Error-recovery behavior and failure conditions ("a report that names 'the SEC ADV bulk feed' fails this gate") are explicit. | 5 / 5 |
Progressive Disclosure | The "Start Here" section routes by task type to four real, one-level-deep reference files (source-map.md, last30days-gtm-corpus.md, query-design.md, fanout-consolidation.md — all present) and the referenced scripts exist. It falls short of anchor 5 because the ~80-line report template and detailed gate rules are inlined in SKILL.md rather than split out, and several referenced targets are missing from the bundle (evals/side-by-side.md, ../deepline-gtm/SKILL.md, ../deepline-analytics/SKILL.md, THIRD_PARTY_NOTICES.md). | 4 / 5 |
Total | 17 / 20 Passed |