Content
65%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 dense, well-structured pipeline skill with concrete weights, formulas, and channel rules, and commendable security discipline (untrusted-content rules, draft-first sending). Its weaknesses are the missing explicit validation checkpoints in a batch outreach workflow (capping workflow clarity), the absent `agents/` files its text depends on, and the all-in-one ~325-line body that forgoes progressive disclosure.
Suggestions
Add an explicit validation step to the pipeline (e.g., Stage 5 step: 'Present drafts to the user with the recommended channel and reason; only send after explicit approval, and verify each draft matches the voice profile before presenting') so the batch-outreach workflow has a real checkpoint rather than scattered 'do not auto-send' rules.
Create the referenced `agents/` files (signal-scorer, mutual-mapper, enrichment-agent, outreach-drafter) or remove the section — the skill currently points at a directory that does not exist in the bundle, which misleads the agent at runtime.
Move the channel-specific outreach rules (email/LinkedIn/X rules, warm-intro and cold-outreach templates) and the MUTUAL RANKING REPORT template into separate reference files linked from SKILL.md, and fix the misplaced paragraph inside the Stage 2 output-format code block.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient — signal weights are expressed as compact tables, channel rules and avoid/anti-pattern lists are terse, and it never explains concepts Claude already knows (it delegates voice modeling to `brand-voice` instead of re-deriving it). Minor trimming opportunities remain: the channel "Avoid" bullets and the later "Anti-Patterns" list overlap, and the misplaced paragraph inside the Stage 2 output-format code block adds noise. Not score 5 because a few sections could be tightened without losing content; not score 3 because padding is minor, not a systematic problem. | 4 / 5 |
Actionability | Guidance is largely concrete: explicit signal/factor weights, a canonical bridge-ranking formula, an output template, per-channel decision rules with a channel-selection order, env-var configuration, and defined agent roles. It stops short of score 5 because the code blocks are illustrative pseudocode rather than runnable tool invocations (e.g., `web_search_exa(query=...)` in a bare Python loop), and the referenced `agents/` subdirectory contains no actual agent definition files in the bundle. | 4 / 5 |
Workflow Clarity | The five-stage pipeline is clearly sequenced with a diagram, but this is a batch outreach workflow and explicit validation checkpoints are missing or only implicit — the draft-first/user-approval gate is stated as a Stage 5 rule rather than as a pipeline step, and there is no "verify the draft against the voice profile / present for user review" step in the sequence. Per the rubric, missing validation in batch operations caps this at 3. It is above score 2 because the sequence itself is complete and coherent. | 3 / 5 |
Progressive Disclosure | The single file is well-sectioned (activation triggers, security rules, one section per stage, config, related skills), but everything is inlined in one ~325-line SKILL.md with no bundle files at all — the referenced `agents/` directory does not exist, so those are dead references rather than one-level-deep navigation. Content that would naturally split out (channel-specific outreach rules, output templates) stays inline, matching the score-3 anchor of "some structure but could be better organized"; it is above score 2 because the sectioning and cross-skill references (`brand-voice`, `social-graph-ranker`) do provide real navigation. | 3 / 5 |
Total | 14 / 20 Passed |