Content
42%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill reads more like a comprehensive reference document than an actionable skill file. It contains useful domain knowledge (salary benchmarks, equity allocation, org structures) but is far too verbose for a SKILL.md, inlining hundreds of lines of reference data that should live in the referenced supporting files. The workflow is present but lacks validation steps, and the actionability is limited to informational guidance rather than concrete executable steps.
Suggestions
Move the detailed salary benchmarks, equity tables, and org chart examples into the referenced files (references/compensation-benchmarks.md, etc.) and keep only a concise summary in SKILL.md
Remove the tautological 'Use this skill when / Do not use this skill when' section and the overview paragraph that restates the title
Add validation checkpoints to the Quick Start workflow, such as 'Verify total equity allocation sums to <100%' or 'Cross-check compensation budget against runway'
Include a concrete worked example showing input (e.g., 'Seed-stage B2B SaaS, $1.5M raised, 3 founders') and expected output format for the team composition analysis
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~400+ lines, extensively listing salary ranges, org charts, and role descriptions that Claude already knows or could infer. Much of this is reference data that should be in separate files rather than inlined. The 'Use this skill when / Do not use this skill when' section is tautological and wastes tokens. | 2 / 5 |
Actionability | The skill provides concrete salary ranges, equity percentages, and formulas (e.g., fully-loaded cost formula, headcount budget formula), which are somewhat actionable. However, there's no executable code, no specific tool usage, and the guidance is more informational/reference than step-by-step executable. The Quick Start section lists steps but they're high-level directions rather than concrete actions. | 3 / 5 |
Workflow Clarity | The Quick Start provides an 8-step sequence that is reasonable for a planning task, but lacks any validation checkpoints or feedback loops. There's no guidance on how to verify the output quality, validate assumptions, or iterate on the plan. For a non-destructive advisory skill this is acceptable but still missing verification steps. | 3 / 5 |
Progressive Disclosure | The skill references external files (references/compensation-benchmarks.md, references/equity-calculator.md, examples/seed-stage-hiring-plan.md, examples/org-chart-evolution.md, resources/implementation-playbook.md) which is good structure, but none of these files exist in the bundle. Meanwhile, the SKILL.md itself inlines massive amounts of reference data (salary benchmarks, equity tables, org charts) that should be in those referenced files, defeating the purpose of progressive disclosure. | 3 / 5 |
Total | 11 / 20 Passed |