Create and enhance prompts, system instructions, and principle files. Capabilities: transform verbose prompts, add patterns/heuristics, optimize token usage, structure CLAUDE.md principles, improve agent/persona definitions, apply prompt engineering techniques (CoT, few-shot, ReAct). Actions: create, enhance, optimize, refactor, compress prompts. Keywords: prompt engineering, system prompt, CLAUDE.md, principle files, instruction optimization, agent prompt, persona prompt, token efficiency, prompt structure, workflow prompts, rules, constraints, few-shot, chain-of-thought, soul, tensions, dialectic. Use when: creating new prompts, enhancing principle files, improving system instructions, optimizing CLAUDE.md, restructuring verbose prompts, adding patterns to workflows, defining agent behaviors.
91
88%
Does it follow best practices?
Impact
95%
1.28xAverage score across 3 eval scenarios
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong, well-structured skill description that excels across all dimensions. It provides comprehensive specificity with concrete actions and techniques, includes extensive natural trigger terms, explicitly addresses both what and when, and occupies a clearly distinct niche. The description uses proper third-person voice throughout and avoids vague fluff.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: transform verbose prompts, add patterns/heuristics, optimize token usage, structure CLAUDE.md principles, improve agent/persona definitions, apply prompt engineering techniques (CoT, few-shot, ReAct). Also enumerates specific verbs: create, enhance, optimize, refactor, compress. | 3 / 3 |
Completeness | Clearly answers both 'what' (create and enhance prompts, system instructions, principle files with specific techniques) and 'when' with an explicit 'Use when:' clause listing seven distinct trigger scenarios including creating new prompts, enhancing principle files, improving system instructions, and optimizing CLAUDE.md. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'prompt engineering', 'system prompt', 'CLAUDE.md', 'principle files', 'agent prompt', 'persona prompt', 'token efficiency', 'few-shot', 'chain-of-thought', 'rules', 'constraints'. These are terms users would naturally use when seeking prompt optimization help. | 3 / 3 |
Distinctiveness Conflict Risk | Occupies a clear niche around prompt engineering and system instruction optimization. The specific terminology (CLAUDE.md, principle files, CoT, few-shot, ReAct, token efficiency) makes it highly distinguishable from general coding, writing, or document skills. Unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-crafted, highly actionable skill that provides genuinely novel prompt engineering patterns (dialectic tensions, expertise transfer via mental models, taxonomy substitution). Its main weakness is length—at 300+ lines with some redundancy between sections, it could benefit from splitting detailed reference material into separate files. The workflow is clear and well-validated, and the concrete examples throughout make it immediately usable.
Suggestions
Extract the building_blocks templates and key_transformations examples into a separate REFERENCE.md file, keeping only a summary table with links in the main skill
Consolidate the expertise_transfer compression rules with the key_transformations section to eliminate redundancy around when to compress vs. preserve
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is quite long (~300+ lines) and includes some redundancy—the key_transformations section repeats concepts already covered in expertise_transfer and building_blocks. The example section and taxonomy examples are useful but verbose. However, most content is genuinely instructive rather than explaining things Claude already knows, and the domain-specific patterns (tensions, dialectic thinking) are novel enough to justify their presence. | 2 / 3 |
Actionability | The skill provides highly concrete, executable guidance: specific XML/YAML templates for building blocks, clear before/after transformation examples, decision tables for mode detection and technique selection, and a complete worked example (startup strategist). The guidance is copy-paste ready and specific enough to produce real outputs. | 3 / 3 |
Workflow Clarity | The workflow is clearly sequenced through the detect_mode table → diagnosis → technique_selection → output_format → building_blocks → validation pipeline. The summary section provides a clean numbered checklist. Validation steps are explicit with four distinct tests (Key Test, Dialectic Test, Compression Test, Taxonomy Test). The commitments section provides clear conditional logic for edge cases. | 3 / 3 |
Progressive Disclosure | The content is entirely self-contained in one file with no references to external documents, which means all the detailed building blocks, transformation examples, and taxonomy references are inline. For a skill this long, some content (like the full building_blocks templates or the extensive key_transformations examples) could be split into referenced files. The internal structure with XML-like sections provides decent organization but it's still a monolithic document. | 2 / 3 |
Total | 10 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
6770aaa
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.