enhance
Master enhancement orchestrator for plugins, agents, prompts, docs, hooks, and skills.
Overview
The enhance plugin provides specialized analyzers for different content types, identifying issues and suggesting improvements based on prompt engineering best practices.
Architecture
/enhance
-> /enhance:agent - Agent-specific analysis (frontmatter, tool restrictions)
-> /enhance:prompt - General prompt patterns (clarity, structure, examples)
-> /enhance:docs - Documentation analysis (RAG optimization, readability)
-> /enhance:plugin - Plugin structure (MCP tools, security patterns)
-> /enhance:claudemd - Project memory optimization (CLAUDE.md/AGENTS.md)
-> /enhance:hooks - Hook definitions (frontmatter, safety)
-> /enhance:skills - SKILL.md structure and triggers
-> /enhance:cross-file - Cross-file consistency (tools, agents, rules)
Analysis depth: Certainty-based findings (HIGH, MEDIUM, LOW)
Auto-fix: Available for HIGH certainty issues with --fix flag
Model selection: Opus for quality-critical analyzers, Sonnet for pattern-based checks
Commands
/enhance
Run all applicable enhancers on current directory.
/enhance # Auto-detect and run all relevant analyzers
/enhance --fix # Apply HIGH certainty auto-fixes
/enhance --verbose # Include LOW certainty issues
/enhance:agent [target]
Analyze agent prompt files for configuration and structure issues.
/enhance:agent # All agents in directory
/enhance:agent my-agent.md # Specific agent
/enhance:agent --fix # Apply auto-fixes
Detects: Missing frontmatter, unrestricted Bash, missing role section, tool configuration issues
/enhance:prompt [target]
Analyze prompts for prompt engineering best practices.
/enhance:prompt # All prompts in directory
/enhance:prompt system-prompt.md # Specific prompt
/enhance:prompt --fix # Apply auto-fixes
Detects: Vague instructions, missing examples, aggressive emphasis, structural issues, invalid code blocks (JSON/JS syntax, language mismatches, heading hierarchy)
/enhance:docs [target]
Analyze documentation for readability and RAG optimization.
/enhance:docs # All docs in directory
/enhance:docs --ai # AI-only mode (aggressive optimization)
/enhance:docs agent-docs/ --ai # Specific directory
Detects: Verbose phrases, poor chunking, broken links, token inefficiency
/enhance:plugin [target]
Analyze plugin structure and MCP tool definitions.
/enhance:plugin # All plugins
/enhance:plugin my-plugin # Specific plugin
/enhance:plugin --fix # Apply auto-fixes
Detects: Missing schema fields, security patterns, version mismatches
/enhance:claudemd
Analyze project memory files (CLAUDE.md, AGENTS.md).
/enhance:claudemd # Find and analyze project memory
/enhance:claudemd --fix # Apply auto-fixes
Detects: Missing sections, broken references, README duplication, cross-platform issues
/enhance:hooks
Analyze hook definitions for frontmatter quality.
/enhance:hooks # All hook definitions
/enhance:hooks pre-commit.md # Specific hook
Detects: Missing frontmatter, missing name/description
/enhance:skills
Analyze SKILL.md files for required metadata and trigger clarity.
/enhance:skills # All SKILL.md files
/enhance:skills enhance-docs # Specific skill
Detects: Missing frontmatter, missing name/description, missing trigger phrase
/enhance:cross-file
Analyze cross-file semantic consistency across agents, skills, and commands.
/enhance:cross-file # Check cross-file consistency
Detects: Tools vs frontmatter mismatches, broken agent references, orphaned agents, skill tool mismatches, duplicate rules, contradictions
Agents
| Agent | Purpose | Model |
|---|
agent-enhancer | Frontmatter, tool restrictions, agent structure | opus |
prompt-enhancer | Clarity, examples, structure, anti-patterns | opus |
docs-enhancer | RAG optimization, readability, token efficiency | opus |
plugin-enhancer | MCP schemas, security patterns, structure | sonnet |
claudemd-enhancer | Project memory validation, cross-platform | opus |
hooks-enhancer | Hook frontmatter, structure, safety | opus |
skills-enhancer | SKILL.md structure, trigger phrases | opus |
cross-file-enhancer | Cross-file semantic consistency (tools, agents, rules) | sonnet |
Certainty Levels
| Level | Meaning | Auto-Fixable |
|---|
| HIGH | Definite issues | Some |
| MEDIUM | Likely improvements | No |
| LOW | Advisory suggestions | No |
