Content
67%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-structured, information-dense workflow with a genuine validation stage and practical operational judgment (token budgets, disambiguation, title variations). Its main defect is that the two central search commands — the Exa primary and the Hunter supplement — contain malformed JSON bodies, so the most frequently executed steps are not copy-paste runnable, capping actionability.
Suggestions
Fix the malformed JSON in the Exa and Hunter curl examples: the Exa body closes after "path":"/search" leaving the query/category/numResults/includeDomains fields outside the -d string, and the Hunter query object is corrupted ("query":{"domain":"{domain","from":"","Step":"","2}":""}); make both complete, copy-paste-ready request bodies.
Remove the duplicated token-budget explanation — the ~800 tokens/result and 50-vs-100-result math appears in both Step 3 and the Tips section; state it once.
Add a fallback for Step 2, e.g., what to do when Brand.dev cannot resolve the company (ask the user for a domain, or fall back to a direct Exa search with the raw company name).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly high-signal operational knowledge Claude cannot be assumed to know (proxy endpoint formats, per-result token costs, Hunter's lack of department filters, expected result counts by team size). It is not a 5 because the Exa token-budget rationale is stated twice — fully in Step 3 ("50 results... ~31K tokens... 100 results would consume ~81K tokens") and again nearly verbatim in the Tips section — which could be trimmed. | 4 / 5 |
Actionability | The Brand.dev and Fiber curl commands are complete and copy-paste ready, but the two most important commands are broken as written: the primary Exa call terminates its JSON early at `-d '{"api":"exa","path":"/search"}''` leaving the query fields outside the quoted body, and the Hunter body is corrupted (`"query":{"domain":"{domain","from":"","Step":"","2}":""}`). That is non-executable guidance with missing key details, matching anchor 3 rather than anchor 4's mostly-executable standard. | 3 / 5 |
Workflow Clarity | Six clearly sequenced steps with a dedicated validation stage (Step 4: verify current company, verify team, deduplicate, flag uncertain matches) and error-recovery guidance (alternate query variations when results are sparse, bumping numResults on exact-count pagination). Anchor 5 would require fully explicit validation checkpoints with feedback loops throughout; gaps like no fallback when Brand.dev fails to resolve the company keep it at 4. | 4 / 5 |
Progressive Disclosure | This is a single-file skill with no references/, scripts/, or assets/ directories, and the body is well-sectioned (Setup, numbered Workflow, Tips) making it easy to navigate. It is not a 5: at ~140 lines everything is inline, and the per-API command details and the Tips section are natural candidates for a one-level-deep reference file, which is a minor organization gap per anchor 4. | 4 / 5 |
Total | 15 / 20 Passed |