awesome-slash 4.0.0 → 4.1.1

package/.agnix.toml

@@ -12,6 +12,7 @@ exclude = [
 ]
 target = "ClaudeCode"
 tools = []
+locale = "en"
 
 [rules]
 skills = true
@@ -22,19 +23,25 @@ plugins = true
 xml = true
 mcp = true
 imports = true
-cross_platform = false  # Intentional - we document all 3 platform paths
+cross_platform = false # Intentional - we document all 3 platform paths
 agents_md = true
-copilot = false  # Not targeting Copilot
-cursor = false   # Not targeting Cursor
+copilot = false # Not targeting Copilot
+cursor = false # Not targeting Cursor
 prompt_engineering = true
 generic_instructions = true
 frontmatter_validation = true
 xml_balance = true
 import_references = true
 disabled_rules = [
-    "hardcoded-claude-path",   # Intentional - we document platform paths
-    "hardcoded-opencode-path", # Intentional - we document platform paths
-    "windows-path-separator",  # False positives on regex escape sequences (\n, \s, \d)
+    "XP-003",      # Intentional - we document all 3 platform paths (.claude/, .opencode/, .codex/)
+    "AS-014",      # False positives on regex escape sequences (\n, \s, \d)
+    "CC-AG-009",   # False positive - Skill, AskUserQuestion, LSP are valid Claude Code tools
+    "CC-MEM-009",  # Intentional - CLAUDE.md uses structured sections, size is necessary
+    "AGM-006",     # Intentional - root AGENTS.md (instructions) + docs/reference/AGENTS.md (reference)
+    "AGM-003",     # docs/reference/AGENTS.md is a comprehensive reference doc
+    "PE-001",      # Reference docs have structured layout; middle placement is intentional
+    "AS-012",      # enhance-hooks is a comprehensive hook reference (needs >500 lines)
+    "CC-SK-009",   # enhance-skills contains example injections for teaching purposes
 ]
 
 [tool_versions]

package/.claude-plugin/marketplace.json

@@ -1,7 +1,7 @@
 {
   "name": "awesome-slash",
-  "description": "10 specialized plugins for AI workflow automation - task orchestration, PR workflow, slop detection, code review, drift detection, enhancement analysis, documentation sync, repo mapping, perf investigations, and topic research",
-  "version": "4.0.0",
+  "description": "11 specialized plugins for AI workflow automation - task orchestration, PR workflow, slop detection, code review, drift detection, enhancement analysis, documentation sync, repo mapping, perf investigations, topic research, and agent config linting",
+  "version": "4.1.1",
   "owner": {
     "name": "Avi Fenesh",
     "url": "https://github.com/avifenesh"
@@ -26,71 +26,78 @@
       "name": "next-task",
       "source": "./plugins/next-task",
       "description": "Master workflow orchestrator: autonomous workflow with model optimization (opus/sonnet/haiku), two-file state management, workflow enforcement gates, 14 specialist agents",
-      "version": "4.0.0",
+      "version": "4.1.1",
       "category": "productivity"
     },
     {
       "name": "ship",
       "source": "./plugins/ship",
       "description": "Complete PR workflow: commit to production, skips review when called from next-task, removes task from registry on cleanup, automatic rollback",
-      "version": "4.0.0",
+      "version": "4.1.1",
       "category": "deployment"
     },
     {
       "name": "deslop",
       "source": "./plugins/deslop",
       "description": "3-phase AI slop detection: regex patterns (HIGH), multi-pass analyzers (MEDIUM), CLI tools (LOW)",
-      "version": "4.0.0",
+      "version": "4.1.1",
       "category": "development"
     },
     {
       "name": "audit-project",
       "source": "./plugins/audit-project",
       "description": "Multi-agent iterative code review until zero issues remain",
-      "version": "4.0.0",
+      "version": "4.1.1",
       "category": "development"
     },
     {
       "name": "drift-detect",
       "source": "./plugins/drift-detect",
       "description": "Deep repository analysis to realign project plans with code reality - detects drift, gaps, and creates prioritized reconstruction plans",
-      "version": "4.0.0",
+      "version": "4.1.1",
       "category": "productivity"
     },
     {
       "name": "enhance",
       "source": "./plugins/enhance",
       "description": "Master enhancement orchestrator: parallel analyzer execution for plugins, agents, docs, CLAUDE.md, and prompts with unified reporting",
-      "version": "4.0.0",
+      "version": "4.1.1",
       "category": "development"
     },
     {
       "name": "sync-docs",
       "source": "./plugins/sync-docs",
       "description": "Standalone documentation sync: find outdated refs, update CHANGELOG, flag stale examples based on code changes",
-      "version": "4.0.0",
+      "version": "4.1.1",
       "category": "development"
     },
     {
       "name": "repo-map",
       "source": "./plugins/repo-map",
       "description": "AST-based repository map generation using ast-grep with incremental updates for faster drift analysis",
-      "version": "4.0.0",
+      "version": "4.1.1",
       "category": "development"
     },
     {
       "name": "perf",
       "source": "./plugins/perf",
       "description": "Rigorous performance investigation workflow with baselines, profiling, hypotheses, and evidence-backed decisions",
-      "version": "4.0.0",
+      "version": "4.1.1",
       "category": "development"
     },
     {
       "name": "learn",
       "source": "./plugins/learn",
       "description": "Research topics online and create comprehensive learning guides with RAG-optimized indexes",
-      "version": "4.0.0",
+      "version": "4.1.1",
       "category": "productivity"
+    },
+    {
+      "name": "agnix",
+      "source": "./plugins/agnix",
+      "description": "Lint agent configuration files (SKILL.md, CLAUDE.md, hooks, MCP) against 155 rules across 10+ AI tools",
+      "version": "4.1.1",
+      "category": "development"
     }
   ]
 }

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "awesome-slash",
-  "version": "4.0.0",
+  "version": "4.1.1",
   "description": "Professional-grade slash commands for Claude Code with cross-platform support",
   "keywords": [
     "workflow",

package/AGENTS.md

@@ -11,7 +11,7 @@
    *WHY: Breaking changes affect all plugin users immediately.*
 
 2. **Plugin for OTHER projects** - Optimize for plugin users, not internal dev convenience.
-   *WHY: Every decision should improve the experience for developers using this in their repos.*
+   *WHY: Every decision MUST improve the experience for developers using this in their repos.*
 
 3. **Use CHANGELOG.md for completion tracking** - MUST use CHANGELOG.md for release notes. NEVER create `*_AUDIT.md`, `*_SUMMARY.md`, `*_COMPLETION.md` files.
    *WHY: Summary files clutter repos and add no value. Report completion verbally.*
@@ -39,7 +39,7 @@
    - Run the `/enhance` command on new or modified commands, agents, skills, hooks or prompts
    - Verify cross-platform compatibility (OpenCode + Codex)
    - Update `bin/cli.js` mappings if new command/agent added
-   - Don't mark complete until ALL checklist items are done
+   - Only mark complete after ALL checklist items are done
    *WHY: Checklists exist because we kept missing things. They are the definition of "done".*
 
 8. **Use plain text markers** - MUST use `[OK]`, `[ERROR]`, `[WARN]`, `[CRITICAL]` for status. NEVER use emojis or ASCII art boxes.
@@ -104,9 +104,21 @@ bin/cli.js    → npm CLI installer
 
 ### Dev Commands
 ```bash
+npx awesome-slash-dev status           # Project health (version, counts, branch)
+npx awesome-slash-dev validate         # Run all validators
+npx awesome-slash-dev validate plugins # Run single validator
+npx awesome-slash-dev bump <version>   # Bump all version files (e.g., 3.7.3)
+npx awesome-slash-dev sync-lib         # Sync lib/ to plugins/
+npx awesome-slash-dev test             # Run test suite
+npx awesome-slash-dev --help           # Show all commands
+
+# Or invoke directly:
+node bin/dev-cli.js <command>
+
+# npm aliases still work:
 npm test                     # Run tests (do before commits)
-npm run bump <version>       # Bump all version files (e.g., 3.7.3)
-./scripts/sync-lib.sh        # Sync lib/ to plugins/
+npm run validate             # All validators via dev-cli
+npm run bump <version>       # Bump versions via dev-cli
 npm pack                     # Build package
 awesome-slash                # Run installer
 ```

package/CHANGELOG.md

@@ -5,8 +5,66 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [4.1.1] - 2025-02-09
+
+### Fixed
+- **Skills $ARGUMENTS parsing** - Added `$ARGUMENTS` parsing to 13 skills that declared `argument-hint` but never consumed the arguments (CC-SK-012)
+- **agnix config** - Migrated `.agnix.toml` `disabled_rules` from deprecated slug format to proper rule IDs (XP-003, AS-014)
+- **Memory file language** - Strengthened imperative language in AGENTS.md/CLAUDE.md (PE-003, CC-MEM-006)
+
 ## [Unreleased]
 
+### Added
+- **Unified Dev CLI** (`awesome-slash-dev`) - Single discoverable entry point for all dev scripts
+  - `awesome-slash-dev validate` runs all 7 validators sequentially
+  - `awesome-slash-dev validate <sub>` runs individual validators (plugins, cross-platform, consistency, etc.)
+  - `awesome-slash-dev status` shows project health (version, plugin/agent/skill counts, git branch)
+  - `awesome-slash-dev bump <version>`, `sync-lib`, `setup-hooks`, `detect`, `verify`, `test`
+  - `awesome-slash-dev --help` lists all commands with descriptions
+  - All existing `npm run` commands still work (now delegate through dev-cli)
+  - All direct `node scripts/foo.js` invocations still work (require.main guards)
+  - No external CLI framework dependencies - hand-rolled parsing matching bin/cli.js style
+
+### Changed
+- **Plugin Discovery** - Convention-based filesystem scanning replaces 14+ hardcoded registration lists (#182)
+  - New `lib/discovery/` module auto-discovers plugins, commands, agents, and skills
+  - `bin/cli.js`, `scripts/dev-install.js`, `scripts/bump-version.js` use discovery calls
+  - Adding a new plugin no longer requires updating registration points
+  - Fixed stale lists in `dev-install.js` and `bump-version.js` (missing learn, agnix)
+  - Added `codex-description` frontmatter for Codex trigger phrases
+  - `scripts/sync-lib.sh` reads from generated `plugins.txt` manifest
+  - Deprecated `adapters/opencode/install.sh` and `adapters/codex/install.sh`
+- **README /agnix Documentation** - Expanded agnix section to be on par with other major commands
+  - Added "The problem it solves" section explaining why agent config linting matters
+  - Added "What it validates" table with 5 categories (Structure, Security, Consistency, Best Practices, Cross-Platform)
+  - Added details about 100 validation rules and their sources
+  - Added CI/CD integration example with GitHub Code Scanning SARIF workflow
+  - Added installation instructions (Cargo, Homebrew)
+  - Added "Why use agnix" value proposition section
+  - Prominent link to [agnix CLI project](https://github.com/avifenesh/agnix)
+  - Updated Commands table with more descriptive entry
+  - Updated skill count to 26 across all references
+
+## [4.1.0] - 2026-02-05
+
+### Added
+- **New /agnix Plugin** - Lint agent configurations before they break your workflow
+  - Validates Skills, Hooks, MCP, Memory, Plugins across Claude Code, Cursor, GitHub Copilot, and Codex CLI
+  - 100 validation rules from official specs, research papers, real-world testing
+  - Auto-fix support with `--fix` flag
+  - SARIF output for GitHub Code Scanning integration
+  - Target-specific validation (`--target claude-code|cursor|codex`)
+  - Requires [agnix CLI](https://github.com/avifenesh/agnix) (`cargo install agnix-cli`)
+
+### Changed
+- **Plugin Count** - Now 11 plugins, 40 agents, 26 skills
+- **CLAUDE.md Rule #11** - Added rule about using `[]` not `<>` for argument hints
+
+### Fixed
+- **Prompt Injection** - Sanitize user arguments in agnix command (validate target, strip newlines from path)
+- **Argument Parsing** - Support both `--target=value` and `--target value` forms
+- **enhance-hooks/SKILL.md** - Fixed path example escaping
+
 ## [4.0.0] - 2026-02-05
 
 ### Added

package/README.md

@@ -1,18 +1,36 @@
-# awesome-slash
+<p align="center">
+  <img src="site/assets/logo.png" alt="awesome-slash" width="120">
+</p>
 
-[![npm version](https://img.shields.io/npm/v/awesome-slash.svg)](https://www.npmjs.com/package/awesome-slash)
-[![npm downloads](https://img.shields.io/npm/dm/awesome-slash.svg)](https://www.npmjs.com/package/awesome-slash)
-[![CI](https://github.com/avifenesh/awesome-slash/actions/workflows/ci.yml/badge.svg)](https://github.com/avifenesh/awesome-slash/actions/workflows/ci.yml)
-[![GitHub stars](https://img.shields.io/github/stars/avifenesh/awesome-slash?style=social)](https://github.com/avifenesh/awesome-slash/stargazers)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+<h1 align="center">awesome-slash</h1>
 
-AI models can write code. That's not the hard part anymore. The hard part is everything else—picking what to work on, managing branches, reviewing output, cleaning up artifacts, handling CI, addressing comments, deploying. **awesome-slash automates the entire workflow**, not just the coding.
+<p align="center">
+  <strong>Automate the entire dev workflow. Not just the coding.</strong>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/awesome-slash"><img src="https://img.shields.io/npm/v/awesome-slash.svg" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/awesome-slash"><img src="https://img.shields.io/npm/dm/awesome-slash.svg" alt="npm downloads"></a>
+  <a href="https://github.com/avifenesh/awesome-slash/actions/workflows/ci.yml"><img src="https://github.com/avifenesh/awesome-slash/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://github.com/avifenesh/awesome-slash/stargazers"><img src="https://img.shields.io/github/stars/avifenesh/awesome-slash?style=social" alt="GitHub stars"></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
+  <a href="https://avifenesh.github.io/awesome-slash/"><img src="https://img.shields.io/badge/Website-awesome--slash-blue?style=flat&logo=github" alt="Website"></a>
+</p>
+
+<p align="center">
+  <b>11 plugins · 40 agents · 26 skills · 26k lines of lib code · 3,357 tests · 3 platforms</b>
+</p>
+
+<p align="center">
+  <a href="#commands">Commands</a> · <a href="#installation">Installation</a> · <a href="https://avifenesh.github.io/awesome-slash/">Website</a> · <a href="https://github.com/avifenesh/awesome-slash/discussions">Discussions</a>
+</p>
 
-**10 plugins · 39 agents · 25 skills · 26k lines of lib code · 3,357 tests · 3 platforms**
+---
 
-If you find this useful: [⭐ Star the repo](https://github.com/avifenesh/awesome-slash)
+AI models can write code. That's not the hard part anymore. The hard part is everything else—picking what to work on, managing branches, reviewing output, cleaning up artifacts, handling CI, addressing comments, deploying. **awesome-slash automates the entire workflow**, not just the coding.
 
 ---
+> Building custom skills, agents, hooks, or MCP tools? [agnix](https://github.com/avifenesh/agnix) is the CLI + LSP linter that catches config errors before they fail silently - real-time IDE validation, auto suggestions, auto-fix, and 155 rules for Cursor, Claude Code, Cline, Copilot, Codex, Windsurf, and more.
 
 ## What This Is
 
@@ -51,6 +69,7 @@ This came from testing on 1,000+ repositories.
 | Command | What it does |
 |---------|--------------|
 | [`/next-task`](#next-task) | Task → exploration → plan → implementation → review → ship |
+| [`/agnix`](#agnix) | **Lint agent configs** - 155 rules for Skills, Memory, Hooks, MCP across 10+ AI tools |
 | [`/ship`](#ship) | Branch → PR → CI → reviews addressed → merge → cleanup |
 | [`/deslop`](#deslop) | 3-phase detection pipeline, certainty-graded findings |
 | [`/perf`](#perf) | 10-phase performance investigation with baselines and profiling |
@@ -67,7 +86,7 @@ Each command works standalone. Together, they form complete workflows.
 
 ## Skills
 
-25 skills included across the plugins:
+26 skills included across the plugins:
 
 | Category | Skills |
 |----------|--------|
@@ -77,6 +96,7 @@ Each command works standalone. Together, they form complete workflows.
 | **Cleanup** | `deslop:deslop`, `sync-docs:sync-docs` |
 | **Analysis** | `drift-detect:drift-analysis`, `repo-map:repo-mapping` |
 | **Learning** | `learn:learn` |
+| **Linting** | `agnix:agnix` |
 
 Skills give your agents specialized capabilities. When you install a plugin, its skills become available to all agents in that session.
 
@@ -87,8 +107,8 @@ Skills give your agents specialized capabilities. When you install a plugin, its
 | Section | What's there |
 |---------|--------------|
 | [The Approach](#the-approach) | Why it's built this way |
-| [Commands](#commands) | All 9 commands overview |
-| [Skills](#skills) | 25 skills across plugins |
+| [Commands](#commands) | All 11 commands overview |
+| [Skills](#skills) | 26 skills across plugins |
 | [Command Details](#command-details) | Deep dive into each command |
 | [How Commands Work Together](#how-commands-work-together) | Standalone vs integrated |
 | [Design Philosophy](#design-philosophy) | The thinking behind the architecture |
@@ -155,6 +175,88 @@ Phase 9 uses the `orchestrate-review` skill to spawn parallel reviewers (code qu
 
 ---
 
+### /agnix
+
+**Purpose:** Lint agent configurations before they break your workflow. The first dedicated linter for AI agent configs.
+
+**[agnix](https://github.com/avifenesh/agnix)** is a standalone open-source project that provides the validation engine. This plugin integrates it into your workflow.
+
+**The problem it solves:**
+
+Agent configurations are code. They affect behavior, security, and reliability. But unlike application code, they have no linting. You find out your SKILL.md is malformed when the agent fails. You discover your hooks have security issues when they're exploited. You realize your CLAUDE.md has conflicting rules when the AI behaves unexpectedly.
+
+agnix catches these issues before they cause problems.
+
+**What it validates:**
+
+| Category | What It Checks |
+|----------|----------------|
+| **Structure** | Required fields, valid YAML/JSON, proper frontmatter |
+| **Security** | Prompt injection vectors, overpermissive tools, exposed secrets |
+| **Consistency** | Conflicting rules, duplicate definitions, broken references |
+| **Best Practices** | Tool restrictions, model selection, trigger phrase quality |
+| **Cross-Platform** | Compatibility across Claude Code, Cursor, Copilot, Codex, OpenCode, Gemini CLI, Cline, and more |
+
+**155 validation rules** (57 auto-fixable) derived from:
+- Official tool specifications (Claude Code, Cursor, GitHub Copilot, Codex CLI, OpenCode, Gemini CLI, and more)
+- Research papers on agent reliability and prompt injection
+- Real-world testing across 500+ repositories
+- Community-reported issues and edge cases
+
+**Supported files:**
+
+| File Type | Examples |
+|-----------|----------|
+| Skills | `SKILL.md`, `*/SKILL.md` |
+| Memory | `CLAUDE.md`, `AGENTS.md`, `.github/CLAUDE.md` |
+| Hooks | `.claude/settings.json`, hooks configuration |
+| MCP | `*.mcp.json`, MCP server configs |
+| Cursor | `.cursor/rules/*.mdc`, `.cursorrules` |
+| Copilot | `.github/copilot-instructions.md` |
+
+**CI/CD Integration:**
+
+agnix outputs SARIF format for GitHub Code Scanning. Add it to your workflow:
+
+```yaml
+- name: Lint agent configs
+  run: agnix --format sarif > results.sarif
+- uses: github/codeql-action/upload-sarif@v3
+  with:
+    sarif_file: results.sarif
+```
+
+**Usage:**
+
+```bash
+/agnix                       # Validate current project
+/agnix --fix                 # Auto-fix fixable issues
+/agnix --strict              # Treat warnings as errors
+/agnix --target claude-code  # Only Claude Code rules
+/agnix --format sarif        # Output for GitHub Code Scanning
+```
+
+**Agent:** agnix-agent (sonnet model)
+
+**External tool:** Requires [agnix CLI](https://github.com/avifenesh/agnix)
+
+```bash
+npm install -g agnix         # Install via npm
+# or
+cargo install agnix-cli      # Install via Cargo
+# or
+brew install agnix           # Install via Homebrew (macOS)
+```
+
+**Why use agnix:**
+- Catch config errors before they cause agent failures
+- Enforce security best practices across your team
+- Maintain consistency as your agent configs grow
+- Integrate validation into CI/CD pipelines
+- Support multiple AI tools from one linter
+
+---
+
 ### /ship
 
 **Purpose:** Takes your current branch from "ready to commit" to "merged PR."
@@ -692,6 +794,9 @@ awesome-slash --development              # Dev mode (bypasses marketplace)
 **For /repo-map:**
 - ast-grep (`sg`) installed
 
+**For /agnix:**
+- [agnix CLI](https://github.com/avifenesh/agnix) installed (`cargo install agnix-cli` or `brew install agnix`)
+
 **Local diagnostics (optional):**
 ```bash
 npm run detect   # Platform detection (CI, deploy, project type)

package/adapters/codex/install.sh

@@ -1,6 +1,10 @@
 #!/usr/bin/env bash
 set -e
 
+# [DEPRECATED] This script is outdated and uses old plugin names.
+# Use instead: awesome-slash --tool codex
+# Or: node scripts/dev-install.js codex
+
 # Codex CLI Installer for awesome-slash commands
 # This script installs all 5 slash commands for use with OpenAI Codex CLI
 

package/adapters/opencode/install.sh

@@ -1,6 +1,10 @@
 #!/usr/bin/env bash
 set -e
 
+# [DEPRECATED] This script is outdated and uses old plugin names.
+# Use instead: awesome-slash --tool opencode
+# Or: node scripts/dev-install.js opencode
+
 # OpenCode Installer for awesome-slash commands
 # This script installs all 5 slash commands for use with OpenCode
 

package/bin/cli.js

@@ -16,6 +16,7 @@ const readline = require('readline');
 const VERSION = require('../package.json').version;
 // Use the installed npm package directory as source (no git clone needed)
 const PACKAGE_DIR = path.join(__dirname, '..');
+const discovery = require('../lib/discovery');
 
 // Valid tool names
 const VALID_TOOLS = ['claude', 'opencode', 'codex'];
@@ -219,9 +220,11 @@ function installForClaude() {
       // May already exist
     }
 
-    // PLUGINS_ARRAY - Install or update plugins
-    const plugins = ['next-task', 'ship', 'deslop', 'audit-project', 'drift-detect', 'enhance', 'sync-docs', 'repo-map', 'perf', 'learn'];
+    // Discover plugins from filesystem convention
+    const plugins = discovery.discoverPlugins(PACKAGE_DIR);
     for (const plugin of plugins) {
+      // Validate plugin name before shell use (prevents injection)
+      if (!/^[a-z0-9][a-z0-9-]*$/.test(plugin)) continue;
       console.log(`  Installing ${plugin}...`);
       try {
         // Try install first
@@ -237,7 +240,7 @@ function installForClaude() {
     }
 
     console.log('\n[OK] Claude Code installation complete!\n');
-    console.log('Commands: /next-task, /ship, /deslop, /audit-project, /drift-detect, /enhance, /perf, /learn');
+    console.log('Commands: ' + plugins.map(p => '/' + p).join(', '));
     return true;
   } catch (err) {
     console.log('[ERROR] Auto-install failed. Manual installation:');
@@ -261,7 +264,7 @@ function installForClaudeDevelopment() {
   }
 
   const pluginsDir = getClaudePluginsDir();
-  const plugins = ['next-task', 'ship', 'deslop', 'audit-project', 'drift-detect', 'enhance', 'sync-docs', 'repo-map', 'perf', 'learn'];
+  const plugins = discovery.discoverPlugins(PACKAGE_DIR);
 
   // Remove marketplace plugins first
   console.log('Removing marketplace plugins...');
@@ -273,6 +276,8 @@ function installForClaudeDevelopment() {
   }
 
   for (const plugin of plugins) {
+    // Validate plugin name before shell use (prevents injection)
+    if (!/^[a-z0-9][a-z0-9-]*$/.test(plugin)) continue;
     try {
       execSync(`claude plugin uninstall ${plugin}@awesome-slash`, { stdio: 'pipe' });
       console.log(`  [OK] Uninstalled ${plugin}`);
@@ -310,7 +315,7 @@ function installForClaudeDevelopment() {
 
   console.log('\n[OK] Claude Code development installation complete!');
   console.log('  Plugins installed to: ' + pluginsDir);
-  console.log('  Commands: /next-task, /ship, /deslop, /audit-project, /drift-detect, /enhance, /perf, /learn');
+  console.log('  Commands: ' + plugins.map(p => '/' + p).join(', '));
   console.log('\n[NOTE] To revert to marketplace version:');
   console.log('  rm -rf ~/.claude/plugins/*@awesome-slash');
   console.log('  awesome-slash --tool claude');
@@ -359,20 +364,8 @@ function installForOpenCode(installDir, options = {}) {
     fs.rmSync(legacyPluginDir, { recursive: true, force: true });
   }
 
-  // OPENCODE_COMMAND_MAPPINGS - Sync command files
-  const commandMappings = [
-    ['deslop.md', 'deslop', 'deslop.md'],
-    ['enhance.md', 'enhance', 'enhance.md'],
-    ['next-task.md', 'next-task', 'next-task.md'],
-    ['delivery-approval.md', 'next-task', 'delivery-approval.md'],
-    ['sync-docs.md', 'sync-docs', 'sync-docs.md'],
-    ['audit-project.md', 'audit-project', 'audit-project.md'],
-    ['ship.md', 'ship', 'ship.md'],
-    ['drift-detect.md', 'drift-detect', 'drift-detect.md'],
-    ['repo-map.md', 'repo-map', 'repo-map.md'],
-    ['perf.md', 'perf', 'perf.md'],
-    ['learn.md', 'learn', 'learn.md']
-  ];
+  // Discover command mappings from filesystem
+  const commandMappings = discovery.getCommandMappings(installDir);
 
   // Helper function to transform content for OpenCode
   function transformForOpenCode(content) {
@@ -387,8 +380,9 @@ function installForOpenCode(installDir, options = {}) {
 
     // Strip plugin prefix from agent references (next-task:agent-name -> agent-name)
     // This is critical - OpenCode agents are installed without the plugin prefix
-    content = content.replace(/`(next-task|deslop|enhance|ship|sync-docs|audit-project|drift-detect|repo-map|perf):([a-z-]+)`/g, '`$2`');
-    content = content.replace(/(next-task|deslop|enhance|ship|sync-docs|audit-project|drift-detect|repo-map|perf):([a-z-]+)/g, '$2');
+    const pluginNames = discovery.discoverPlugins(installDir).join('|');
+    content = content.replace(new RegExp('`(' + pluginNames + '):([a-z-]+)`', 'g'), '`$2`');
+    content = content.replace(new RegExp('(' + pluginNames + '):([a-z-]+)', 'g'), '$2');
 
     // Transform ALL code blocks (with OR without language identifier)
     // Pattern matches: ```javascript, ```js, ```bash, or just ``` (unmarked)
@@ -575,7 +569,7 @@ After user answers, proceed to Phase 2 with the selected policy.
   fs.mkdirSync(agentsDir, { recursive: true });
 
   console.log('  Installing agents for OpenCode...');
-  const pluginDirs = ['next-task', 'enhance', 'audit-project', 'drift-detect', 'ship', 'deslop', 'repo-map', 'perf', 'sync-docs', 'learn'];
+  const pluginDirs = discovery.discoverPlugins(installDir);
   let agentCount = 0;
 
   for (const pluginName of pluginDirs) {
@@ -687,7 +681,7 @@ After user answers, proceed to Phase 2 with the selected policy.
   console.log(`   Commands: ${commandsDir}`);
   console.log(`   Agents: ${agentsDir}`);
   console.log(`   Plugin: ${pluginDir}`);
-  console.log('   Access via: /next-task, /ship, /deslop, /audit-project, /drift-detect, /enhance, /sync-docs, /perf, /learn');
+  console.log('   Access via: ' + commandMappings.map(([target]) => '/' + target.replace(/\.md$/, '')).join(', '));
   console.log('   Native features: Auto-thinking selection, workflow enforcement, session compaction\n');
   return true;
 }
@@ -727,33 +721,8 @@ function installForCodex(installDir) {
     }
   }
 
-  // Skill mappings: [skillName, plugin, sourceFile, description]
-  // CODEX_SKILL_MAPPINGS - Skills with trigger-phrase descriptions
-  // Format: "Use when user asks to 'phrase1', 'phrase2'. Description of what it does."
-  const skillMappings = [
-    ['enhance', 'enhance', 'enhance.md',
-      'Use when user asks to "enhance prompts", "improve agents", "analyze plugins", "optimize documentation", "review CLAUDE.md". Runs 5 parallel analyzers on prompts, agents, plugins, docs, and project memory files.'],
-    ['next-task', 'next-task', 'next-task.md',
-      'Use when user asks to "find next task", "what should I work on", "automate workflow", "implement and ship", "run next-task". Orchestrates complete task-to-production workflow: discovery, implementation, review, and delivery.'],
-    ['ship', 'ship', 'ship.md',
-      'Use when user asks to "ship this", "create PR", "merge to main", "deploy changes", "push to production". Complete PR workflow: commit, create PR, monitor CI, merge, deploy, validate.'],
-    ['deslop', 'deslop', 'deslop.md',
-      'Use when user asks to "clean up slop", "remove AI artifacts", "deslop the codebase", "find debug statements", "remove console.logs", "repo hygiene". Detects and removes AI-generated slop patterns.'],
-    ['audit-project', 'audit-project', 'audit-project.md',
-      'Use when user asks to "review my code", "check for issues", "run code review", "analyze PR quality". Multi-agent iterative review that loops until all critical/high issues are resolved.'],
-    ['drift-detect', 'drift-detect', 'drift-detect.md',
-      'Use when user asks to "check plan drift", "compare docs to code", "verify roadmap", "scan for reality gaps". Analyzes documentation vs actual code to detect drift and outdated plans.'],
-    ['repo-map', 'repo-map', 'repo-map.md',
-      'Use when user asks to "create repo map", "generate repo map", "update repo map", "repo map status", "map symbols". Builds and updates AST-based repo map using ast-grep.'],
-    ['perf', 'perf', 'perf.md',
-      'Use when user asks to "run perf", "performance investigation", "benchmark regression", "profiling workflow", "baseline performance". Runs structured perf investigations with baselines, profiling, hypotheses, and decisions.'],
-    ['delivery-approval', 'next-task', 'delivery-approval.md',
-      'Use when user asks to "validate delivery", "approve for shipping", "check if ready to ship", "verify task completion". Autonomous validation that tests pass, build succeeds, and requirements are met.'],
-    ['sync-docs', 'sync-docs', 'sync-docs.md',
-      'Use when user asks to "update docs", "sync documentation", "fix outdated docs", "refresh README". Compares documentation to actual code and fixes discrepancies.'],
-    ['learn', 'learn', 'learn.md',
-      'Use when user asks to "learn about topic", "research subject", "create learning guide", "build knowledge base", "study topic". Gathers online sources and synthesizes comprehensive guide with RAG index.']
-  ];
+  // Discover skill mappings from filesystem (descriptions from codex-description frontmatter)
+  const skillMappings = discovery.getCodexSkillMappings(installDir);
 
   for (const [skillName, plugin, sourceFile, description] of skillMappings) {
     const srcPath = path.join(installDir, 'plugins', plugin, 'commands', sourceFile);