{"id":48044630,"url":"https://github.com/agent-sh/enhance","last_synced_at":"2026-04-04T14:16:55.688Z","repository":{"id":339696622,"uuid":"1163064509","full_name":"agent-sh/enhance","owner":"agent-sh","description":"Plugin structure and tool use analyzer - validates plugin.json, MCP tools, and security patterns","archived":false,"fork":false,"pushed_at":"2026-03-25T00:14:23.000Z","size":1770,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-26T06:25:23.002Z","etag":null,"topics":["ai","claude","code-quality","devtools","javascript","linter","mcp","plugin","security","validation"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/agent-sh.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-02-21T03:27:37.000Z","updated_at":"2026-03-25T00:14:21.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/agent-sh/enhance","commit_stats":null,"previous_names":["agent-sh/enhance"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/agent-sh/enhance","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agent-sh%2Fenhance","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agent-sh%2Fenhance/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agent-sh%2Fenhance/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agent-sh%2Fenhance/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/agent-sh","download_url":"https://codeload.github.com/agent-sh/enhance/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agent-sh%2Fenhance/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31402278,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T10:20:44.708Z","status":"ssl_error","status_checked_at":"2026-04-04T10:20:06.846Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","claude","code-quality","devtools","javascript","linter","mcp","plugin","security","validation"],"created_at":"2026-04-04T14:16:55.560Z","updated_at":"2026-04-04T14:16:55.662Z","avatar_url":"https://github.com/agent-sh.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# enhance\n\nMaster enhancement orchestrator for plugins, agents, prompts, docs, hooks, and skills.\n\n## Overview\n\nThe enhance plugin provides specialized analyzers for different content types, identifying issues and suggesting improvements based on prompt engineering best practices.\n\n## Architecture\n\n```\n/enhance\n    │\n    ├─→ /enhance:agent   → Agent-specific analysis (frontmatter, tool restrictions)\n    ├─→ /enhance:prompt  → General prompt patterns (clarity, structure, examples)\n    ├─→ /enhance:docs    → Documentation analysis (RAG optimization, readability)\n    ├─→ /enhance:plugin  → Plugin structure (MCP tools, security patterns)\n    ├─→ /enhance:claudemd → Project memory optimization (CLAUDE.md/AGENTS.md)\n    ├─→ /enhance:hooks   → Hook definitions (frontmatter, safety)\n    └─→ /enhance:skills  → SKILL.md structure and triggers\n```\n\n**Analysis depth**: Certainty-based findings (HIGH, MEDIUM, LOW)\n**Auto-fix**: Available for HIGH certainty issues with `--fix` flag\n**Model selection**: Opus for quality-critical analyzers, Sonnet for pattern-based checks\n\n## Commands\n\n### `/enhance`\n\nRun all applicable enhancers on current directory.\n\n```\n/enhance                    # Auto-detect and run all relevant analyzers\n/enhance --fix              # Apply HIGH certainty auto-fixes\n/enhance --verbose          # Include LOW certainty issues\n```\n\n### `/enhance:agent [target]`\n\nAnalyze agent prompt files for configuration and structure issues.\n\n```\n/enhance:agent                     # All agents in directory\n/enhance:agent my-agent.md         # Specific agent\n/enhance:agent --fix               # Apply auto-fixes\n```\n\n**Detects**: Missing frontmatter, unrestricted Bash, missing role section, tool configuration issues\n\n### `/enhance:prompt [target]`\n\nAnalyze prompts for prompt engineering best practices.\n\n```\n/enhance:prompt                    # All prompts in directory\n/enhance:prompt system-prompt.md   # Specific prompt\n/enhance:prompt --fix              # Apply auto-fixes\n```\n\n**Detects**: Vague instructions, missing examples, aggressive emphasis, structural issues, invalid code blocks (JSON/JS syntax, language mismatches, heading hierarchy)\n\n### `/enhance:docs [target]`\n\nAnalyze documentation for readability and RAG optimization.\n\n```\n/enhance:docs                      # All docs in directory\n/enhance:docs --ai                 # AI-only mode (aggressive optimization)\n/enhance:docs agent-docs/ --ai     # Specific directory\n```\n\n**Detects**: Verbose phrases, poor chunking, broken links, token inefficiency\n\n### `/enhance:plugin [target]`\n\nAnalyze plugin structure and MCP tool definitions.\n\n```\n/enhance:plugin                    # All plugins\n/enhance:plugin my-plugin          # Specific plugin\n/enhance:plugin --fix              # Apply auto-fixes\n```\n\n**Detects**: Missing schema fields, security patterns, version mismatches\n\n### `/enhance:claudemd`\n\nAnalyze project memory files (CLAUDE.md, AGENTS.md).\n\n```\n/enhance:claudemd                  # Find and analyze project memory\n/enhance:claudemd --fix            # Apply auto-fixes\n```\n\n**Detects**: Missing sections, broken references, README duplication, cross-platform issues\n\n### `/enhance:hooks`\n\nAnalyze hook definitions for frontmatter quality.\n\n```\n/enhance:hooks                     # All hook definitions\n/enhance:hooks pre-commit.md        # Specific hook\n```\n\n**Detects**: Missing frontmatter, missing name/description\n\n### `/enhance:skills`\n\nAnalyze SKILL.md files for required metadata and trigger clarity.\n\n```\n/enhance:skills                     # All SKILL.md files\n/enhance:skills enhance-docs         # Specific skill\n```\n\n**Detects**: Missing frontmatter, missing name/description, missing trigger phrase\n\n## Agents\n\n| Agent | Purpose | Model |\n|-------|---------|-------|\n| `agent-enhancer` | Frontmatter, tool restrictions, agent structure | opus |\n| `prompt-enhancer` | Clarity, examples, structure, anti-patterns | opus |\n| `docs-enhancer` | RAG optimization, readability, token efficiency | opus |\n| `plugin-enhancer` | MCP schemas, security patterns, structure | sonnet |\n| `claudemd-enhancer` | Project memory validation, cross-platform | opus |\n| `hooks-enhancer` | Hook frontmatter, structure, safety | opus |\n| `skills-enhancer` | SKILL.md structure, trigger phrases | opus |\n\n## Certainty Levels\n\n| Level | Meaning | Auto-Fixable |\n|-------|---------|--------------|\n| HIGH | Definite issues | Some |\n| MEDIUM | Likely improvements | No |\n| LOW | Advisory suggestions | No |\n\nLOW certainty issues only shown with `--verbose` flag.\n\n## Common Flags\n\n| Flag | Description |\n|------|-------------|\n| `--fix` | Apply HIGH certainty auto-fixes |\n| `--verbose` | Include LOW certainty issues |\n| `--dry-run` | Show what would be fixed without applying |\n| `--ai` | AI-only mode (docs analyzer) |\n| `--both` | Both audiences mode (docs analyzer, default) |\n\n## Output Format\n\nEach analyzer generates a markdown report:\n\n```markdown\n## Analysis: {name}\n\n**File**: {path}\n**Analyzed**: {timestamp}\n\n### Summary\n- HIGH: {count} issues\n- MEDIUM: {count} issues\n- LOW: {count} issues (verbose only)\n\n### {Category} Issues ({n})\n\n| Issue | Fix | Certainty |\n|-------|-----|-----------|\n| Description | Suggested fix | HIGH |\n```\n\n## Integration\n\nCan be invoked by:\n- Direct command: `/enhance:*`\n- Phase 9 review loop during workflow\n- `delivery-validator` before shipping\n- Individual analysis workflows\n\n## Requirements\n\n- Claude Code\n- Node.js (for lib functions)\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagent-sh%2Fenhance","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fagent-sh%2Fenhance","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagent-sh%2Fenhance/lists"}