Content
25%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 long, marketing-style catalog of capabilities, domains, and integration patterns, padded with concepts Claude already knows and built around code examples that are pseudocode (undefined variables and helper functions throughout). It begins with a malformed second YAML frontmatter block, has no bundle files or progressive disclosure, and its workflows lack any validation checkpoints or concrete commands.
Suggestions
Cut the buzzword catalogs (Application Domains, Integration Patterns, Performance Optimization, Advanced Graph Algorithms) and the closing self-promotional paragraph — they restate knowledge Claude already has; keep only tool names, parameters, and one worked example.
Make code examples runnable by defining inputs and replacing undefined helpers (extractTopRecommendations(), identifyInfluencers(), load_graph_partition(), etc.) with concrete code or explicit instructions.
Add validation checkpoints to the Example Workflows (e.g. check PageRank convergence/iteration results before reporting scores) and move detailed material into references/ files linked one level deep from SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~290-line body is heavily padded with buzzword catalogs of concepts Claude already knows — e.g. "**Spectral Clustering**: Use spectral methods", "**GPU Acceleration**: Leverage GPU computing", "**Sparse Representations**: Use efficient sparse matrix representations", "**Viral Marketing**: Optimize viral marketing campaign targeting" — plus a duplicate YAML frontmatter block and a closing self-promotional paragraph. This matches anchor 1 ('Severely verbose... heavily padded'); it never rises to 2 because almost none of the bulk adds information Claude lacks. | 1 / 5 |
Actionability | Real MCP tool names with concrete parameters are given (e.g. `mcp__sublinear-time-solver__pageRank` with `damping: 0.85, epsilon: 1e-8, maxIterations: 1000`), but every code example depends on undefined inputs and helper functions — `edgeWeights`, `userItemGraph`, `socialNetworkAdjacency`, `extractTopRecommendations()`, `identifyInfluencers()`, `load_graph_partition()`, `compute_local_pagerank()`, `synchronize_scores()` — making them pseudocode rather than executable guidance. This fits anchor 3 ('Some concrete guidance but incomplete; pseudocode instead of executable code'); not 4 because no example runs as written, not 2 because tool names, argument shapes, and parameter values are genuinely specific. | 3 / 5 |
Workflow Clarity | The 'Example Workflows' are numbered but purely abstract — e.g. "1. **Network Construction**: Build social network graph from user interactions ... 5. **Impact Measurement**: Measure campaign impact using network metrics" — with no commands, no validation checkpoints, and no error-recovery loops, mirroring anchor 2's '1. Open the document / 2. Make changes / 3. Save and close'. Not 3 because the steps are not executable or verifiable in any form (no convergence checks, no verification of results); not 1 because a rough sequence is at least listed. | 2 / 5 |
Progressive Disclosure | There are no bundle files (no references/, scripts/, or assets/ exist) and the entire ~290-line monolith — tool catalog, six code examples, domain listings, integration patterns, and workflows — is inlined in SKILL.md with no references or navigation, matching anchor 2 ('content that clearly belongs in separate files is inlined'). Not 3 because there are no references at all to signal, only section headers over inlined bulk; not 1 because the body is at least sectioned into navigable headers rather than a wall of text. | 2 / 5 |
Total | 8 / 20 Passed |