Content
70%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 workflow with explicit contracts and human checkpoints at every step — the process engineering is excellent. The weaknesses are a monolithic single-file structure that inlines material (title lists, filter code) belonging in bundle files, and recurring rationale/meta sections plus duplicated guidance that inflate the token cost.
Suggestions
Move the Apollo title list and the `is_valid_gtm_leader` post-filter function into references/ (e.g. references/apollo-titles.md, scripts/filter_titles.py) and reference them from Step 0/Phase 2, cutting roughly 100 lines from SKILL.md.
Trim or cut the "Why leadership changes work", "Why this beats web search", and "Key Difference from Other Signal Composites" sections — keep one line of rationale each and drop the rest.
Deduplicate the rate-limit guidance (Phase 3 and the Apollo-Specific Tips both state the 0.5s-delay/Retry-After advice) into a single place, and complete the Phase 4 lookback-check code so the detection step is copy-paste runnable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient — tables, contracts, and code earn their tokens — but there is real padding: the "Why leadership changes work" sales-psychology rationale, "Why this beats web search", and the "Key Difference from Other Signal Composites" meta-section explain context Claude could infer, and rate-limit guidance is stated twice (Phase 3 and the Tips section). Not a 2 because the bulk is dense, useful operational detail. | 3 / 5 |
Actionability | Mostly executable: a complete `is_valid_gtm_leader` post-filter function, concrete `search_people` filter dicts, the exact `people/match` payload with `id`, explicit input/output contracts per step, and specific config schemas. Minor gaps keep it from 5: Phase 4 change detection is partial (lookback check left as a comment), the enrichment call is shown as URL+payload rather than a runnable call, and Step 5 defers entirely to another skill. | 4 / 5 |
Workflow Clarity | Six steps (0–5) each with a stated Purpose, Input Contract, Process, Output Contract, and an explicit Human Checkpoint, plus an Execution Summary table. Error recovery is present (429 handling with Retry-After, pagination when total_entries > 100, credit accounting surfaced at the checkpoint) — matching the top anchor's sequence, validation, and feedback-loop criteria. | 5 / 5 |
Progressive Disclosure | Good in-document structure (clear step headers, contracts, checkpoints), but the skill is a ~690-line monolith with no bundle files at all: the 28-line Apollo title list, the ~45-line post-filter function, and the full config question tables are inlined content that clearly belongs in references/ or scripts/ files. It sits between anchor 2 (separate-file content inlined) and anchor 3 (some structure, should-be-separate content inline) — structure is better than minimal, so 3. | 3 / 5 |
Total | 15 / 20 Passed |