Content
35%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.
The body is a well-organized but hollow capability brochure: it describes what a performance analyzer would do in generic terms without a single command, code snippet, tool, or measurement technique that would let Claude actually perform the analysis. Its clearest asset is the three-phase workflow outline and the report template; its biggest liabilities are padding, the stray duplicate frontmatter block, and the complete absence of executable guidance.
Suggestions
Replace the generic detection/optimization bullet lists with concrete commands or code (e.g., timing wrappers, profiling invocations, how to compute parallelization ratio from a run log) so the skill instructs rather than describes.
Move the bottleneck-pattern catalog, KPI definitions, and report format into a references/ file (e.g. PATTERNS.md, REPORT-TEMPLATE.md) and keep SKILL.md as a lean overview with clearly signaled links.
Delete the stray second YAML frontmatter block at the top of the body and add validation checkpoints to the workflow (e.g., 'confirm the metric baseline is statistically meaningful before recommending a change; re-measure after applying to verify the improvement').
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~200-line body is noticeably padded with knowledge Claude already has — generic bullets like 'Resource Constraints: CPU, memory, or I/O limitations', 'Algorithm improvements', and 'Caching strategies' add no skill-specific information. It also opens with a stray duplicated YAML frontmatter block (name, capabilities, hooks) that is dead weight in the body. This matches anchor 2 ('Noticeably verbose; several unnecessary explanations or padded sections') rather than 1, since there is no extended tutorial-style prose explaining basics. | 2 / 5 |
Actionability | There is no executable code, command, tool name, or metric-gathering method anywhere — the 'Analysis Workflow' phases are abstract numbered hints ('Gather execution metrics', 'Compare against baselines') and the 'Optimization Examples' assert results ('70% reduction to 3 minutes') without showing how they were achieved. Only the markdown report template is semi-concrete. This matches anchor 2 ('Minimal concrete guidance; high-level hints but missing the specific steps to execute') and falls short of 3, which would require at least pseudocode-level or partially complete instructions. | 2 / 5 |
Workflow Clarity | A clear three-phase sequence exists (Data Collection → Analysis → Recommendation) with five enumerated steps each, matching anchor 3 ('Steps listed but validation gaps; sequence present but checkpoints missing'). It cannot score 4: there are no validation checkpoints or error-recovery loops (e.g., how to verify a suspected bottleneck or handle insufficient metrics), and the steps are generic rather than tied to concrete commands. The destructive/batch cap does not apply since the skill is read-only analysis. | 3 / 5 |
Progressive Disclosure | The body has a reasonable section structure (capabilities, workflow, patterns, metrics, examples), but at ~200 lines everything lives in one file — the bottleneck-pattern catalog, KPI definitions, and report format clearly belong in separate reference files — and no references exist at all. This matches anchor 3 ('Some structure but could be better organized; content that should be separate is inline'). The 5-scoring exception for under-50-line skills does not apply. | 3 / 5 |
Total | 10 / 20 Passed |