Content
38%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 buzzword-heavy monolith: padded role/roadmap sections, non-executable code skeletons calling undefined functions, and workflows with no validation checkpoints. Its one progressive-disclosure reference points to a nonexistent file, so the skill never tells Claude how to actually invoke the tool.
Suggestions
Cut the buzzword padding — 'Role and Purpose', 'Advanced Integration Capabilities', and 'Future Roadmap' add no instructions and waste context tokens.
Split the seven extraction strategies, format/database listings, and code examples into the referenced resources/implementation-playbook.md (which currently does not exist) and keep SKILL.md a concise overview with a working link.
Make the code executable or replace it with the tool's actual invocation: extract_project_context() depends on helper functions that are never defined anywhere in the skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Several sections are pure padding — 'An elite context engineering specialist focused on comprehensive, semantic, and dynamically adaptable context preservation', 'Advanced Integration Capabilities', and 'Future Roadmap' — plus empty bullets like 'Use advanced compression algorithms' and 'Optimize storage efficiency'. This is noticeably verbose (anchor 2) rather than severely verbose (anchor 1), since no basic concepts are re-explained and real content (parameters, formats, code) is interwoven. | 2 / 5 |
Actionability | The code examples are non-executable skeletons — extract_project_context() calls extract_project_metadata(), analyze_architecture(), build_dependency_graph(), and generate_semantic_tags(), none defined anywhere, and compress_context() references equally undefined strategy functions. This matches anchor 3 ('pseudocode instead of executable code; missing key details'); it is above anchor 2 because enumerated input parameters, supported formats, named vector databases, and a JSON schema provide some concrete grounding, but below anchor 4 because no actual tool invocation is ever shown. | 3 / 5 |
Workflow Clarity | The two 'Reference Workflows' list numbered, logically ordered steps ('Analyze project structure... Store in vector database') but include no commands and no validation checkpoints — the 'Apply relevant best practices and validate outcomes' bullet is a hand-wave. This matches anchor 3 ('sequence present but checkpoints missing or implicit'); it is above anchor 2 because the sequences are complete and coherent rather than gapped, and below anchor 4 because no checkpoints exist at all. | 3 / 5 |
Progressive Disclosure | All detail — seven extraction strategies, format and database listings, and code examples — is inlined in a ~175-line monolithic SKILL.md, and its single reference ('open resources/implementation-playbook.md') points to a file that does not exist in the bundle. This matches anchor 2 ('content that clearly belongs in separate files is inlined'); it falls below anchor 3 because the only reference is a broken path rather than a usable pointer. | 2 / 5 |
Total | 10 / 20 Passed |