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 persona/résumé-style document that enumerates the AI-engineering technology landscape — all knowledge Claude already has — rather than adding skill-specific value. It contains no executable guidance, code, or reference files, and its length works directly against the token budget.
Suggestions
Strip the Capabilities, Knowledge Base, and Behavioral Traits catalogs: Claude already knows these technologies and traits; keep only project-specific conventions, tool choices, or patterns the user wants standardized.
Replace the abstract Instructions and Response Approach with concrete, executable guidance — e.g., a starter RAG architecture template, named stack defaults, code snippets for the common cases, and specific validation commands.
If any detailed material must be retained, move it to references/ files and link them one level deep from a lean SKILL.md overview, rather than inlining everything.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Roughly 100 of the 163 lines are catalogs of technologies and techniques Claude already knows ('OpenAI GPT-4o/4o-mini, o1-preview...', 'Pinecone, Qdrant, Weaviate, Chroma...', 'chain-of-thought, tree-of-thoughts, self-consistency'), and the 'Purpose' and 'Knowledge Base' sections restate the description and general domain awareness. It avoids prose explanations of known concepts (so not a 1), but nearly every padded section is unnecessary. | 2 / 5 |
Actionability | The guidance is entirely abstract — 'Design the AI architecture, data flow, and model selection', 'Implement with monitoring, safety, and cost controls' — with no code, commands, templates, or specific executable steps anywhere in the body. It provides a high-level process hint (above the purely vague anchor 1) but nothing concrete enough to execute. | 2 / 5 |
Workflow Clarity | The Instructions section lists a real sequence (clarify → design → implement → validate) and step 4 mentions validation ('Validate with tests and staged rollout plans'), so validation is not absent. However, each step is a single vague sentence with no checkpoints, feedback loops, or error-recovery guidance, matching the 'steps listed but validation gaps' anchor. | 3 / 5 |
Progressive Disclosure | The body has genuine structure (13 well-organized ## and ### sections), but it is monolithic: the 100+ lines of capability catalogs that belong in separate reference files (or nowhere) are fully inlined, and the skill ships no references at all. This fits 'some structure but content that should be separate is inline' better than the minimal-structure anchor 2. | 3 / 5 |
Total | 10 / 20 Passed |