fix: restructure to single-plugin layout + add components.json

Author: avifenesh

.claude-plugin/plugin.json

@@ -1,14 +1,14 @@
 {
   "name": "enhance",
-  "version": "1.0.0",
+  "version": "5.1.0",
   "description": "Plugin structure and tool use analyzer - validates plugin.json, MCP tools, and security patterns",
   "author": {
     "name": "Avi Fenesh",
     "email": "[email protected]",
     "url": "https://github.com/avifenesh"
   },
-  "homepage": "https://github.com/agent-sh/enhance",
-  "repository": "https://github.com/agent-sh/enhance",
+  "homepage": "https://github.com/agent-sh/agentsys#enhance",
+  "repository": "https://github.com/agent-sh/agentsys",
   "license": "MIT",
   "keywords": [
     "plugin-analyzer",

README.md

@@ -1,26 +1,188 @@
 # enhance
 
-Plugin structure and tool use analyzer - validates plugin.json, MCP tools, and security patterns
+Master enhancement orchestrator for plugins, agents, prompts, docs, hooks, and skills.
 
-## Installation
+## Overview
 
-```bash
-# Claude Code
-claude mcp add-plugin agent-sh/enhance
+The enhance plugin provides specialized analyzers for different content types, identifying issues and suggesting improvements based on prompt engineering best practices.
 
-# Or install from marketplace
-agentsys install enhance
+## 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
 ```
 
-## Usage
+**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
+/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
 ```
 
-## Keywords
+**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
+
+## 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 | sonnet |
+| `skills-enhancer` | SKILL.md structure, trigger phrases | sonnet |
+
+## Certainty Levels
+
+| Level | Meaning | Auto-Fixable |
+|-------|---------|--------------|
+| HIGH | Definite issues | Some |
+| MEDIUM | Likely improvements | No |
+| LOW | Advisory suggestions | No |
+
+LOW certainty issues only shown with `--verbose` flag.
+
+## Common Flags
+
+| Flag | Description |
+|------|-------------|
+| `--fix` | Apply HIGH certainty auto-fixes |
+| `--verbose` | Include LOW certainty issues |
+| `--dry-run` | Show what would be fixed without applying |
+| `--ai` | AI-only mode (docs analyzer) |
+| `--both` | Both audiences mode (docs analyzer, default) |
+
+## Output Format
+
+Each analyzer generates a markdown report:
+
+```markdown
+## Analysis: {name}
+
+**File**: {path}
+**Analyzed**: {timestamp}
+
+### Summary
+- HIGH: {count} issues
+- MEDIUM: {count} issues
+- LOW: {count} issues (verbose only)
+
+### {Category} Issues ({n})
+
+| Issue | Fix | Certainty |
+|-------|-----|-----------|
+| Description | Suggested fix | HIGH |
+```
+
+## Integration
+
+Can be invoked by:
+- Direct command: `/enhance:*`
+- Phase 9 review loop during workflow
+- `delivery-validator` before shipping
+- Individual analysis workflows
+
+## Requirements
 
-`plugin-analyzer`, `mcp-tools`, `validation`, `security`, `best-practices`
+- Claude Code
+- Node.js (for lib functions)
 
 ## License