Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A thorough, well-structured operational guide with clear workflows, validation checkpoints, and concrete action guidance. Its main weaknesses are length/repeated guardrails and a monolithic single-file structure with a malformed cross-skill anchor link.
Suggestions
Consolidate the repeated 'do not guess / do not overstate / do not present as ground truth' cautions into a single guardrails section instead of restating them across Search, Enrichment, Similarity, and Output sections.
Fix the malformed anchor 'plugins/sales/skills/index/SKILL.md## Cross-Skill Best Practices' (double '##') so the cross-skill reference resolves correctly.
Consider splitting the long body into a bundled reference (e.g., references/identifier-resolution.md) to keep SKILL.md a lean overview and improve progressive-disclosure navigation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The guide is dense and operational rather than padded with concepts Claude already knows, but at ~220 lines it repeats the same cautionary guardrails ('Do not guess/overstate/present as ground truth') across many sections and could be consolidated. Not score 3 because it could be tightened; not score 1 because it is not verbose concept-explanation fluff. | 2 / 3 |
Actionability | Names specific connector actions (lookup, search_companies, enrich_contacts, find_similar_companies, get_recommended_contacts), concrete filter/lookup value categories, explicit recommendation use cases, and a copy-ready output table template — actionable instruction without code, which the rubric does not penalize for instruction-only skills. | 3 / 3 |
Workflow Clarity | The 'Default Resolution Pattern' is a clear ordered 1–6 sequence with an explicit validation checkpoint (step 5: verify rows satisfy hard constraints) and a retry-once-then-report feedback loop for identifier-shape rejection; 'Failure Handling' adds explicit error states. | 3 / 3 |
Progressive Disclosure | The skill is a single self-contained file with no bundle (references/scripts/assets absent) and is well-sectioned, but at 220+ lines it is a monolithic body with no internal file split; external pointers go to a parent skill (../index/SKILL.md) and one anchor is malformed ('SKILL.md## Cross-Skill Best Practices'), so navigation is present but not cleanly signaled. | 2 / 3 |
Total | 10 / 12 Passed |