SpillwaveSolutions · RichardHightower · Dec 29, 2025 · Dec 29, 2025
diff --git a/README.md b/README.md
@@ -1,308 +1,110 @@
-# Claude Code Plugins: Orchestration and Automation
 
-> **⚡ Updated for Opus 4.5, Sonnet 4.5 & Haiku 4.5** — Three-tier model strategy for optimal performance
 
-[![Run in Smithery](https://smithery.ai/badge/skills/wshobson)](https://smithery.ai/skills?ns=wshobson&utm_source=github&utm_medium=badge)
+## Installing with Skilz (Universal Installer)
 
-> **🎯 Agent Skills Enabled** — 107 specialized skills extend Claude's capabilities across plugins with progressive disclosure
+The recommended way to install this skill across different AI coding agents is using the **skilz** universal installer.
 
-A comprehensive production-ready system combining **99 specialized AI agents**, **15 multi-agent workflow orchestrators**, **107 agent skills**, and **71 development tools** organized into **67 focused, single-purpose plugins** for [Claude Code](https://docs.claude.com/en/docs/claude-code/overview).
+### Install Skilz
 
-## Overview
-
-This unified repository provides everything needed for intelligent automation and multi-agent orchestration across modern software development:
-
-- **67 Focused Plugins** - Granular, single-purpose plugins optimized for minimal token usage and composability
-- **99 Specialized Agents** - Domain experts with deep knowledge across architecture, languages, infrastructure, quality, data/AI, documentation, business operations, and SEO
-- **107 Agent Skills** - Modular knowledge packages with progressive disclosure for specialized expertise
-- **15 Workflow Orchestrators** - Multi-agent coordination systems for complex operations like full-stack development, security hardening, ML pipelines, and incident response
-- **71 Development Tools** - Optimized utilities including project scaffolding, security scanning, test automation, and infrastructure setup
-
-### Key Features
-
-- **Granular Plugin Architecture**: 67 focused plugins optimized for minimal token usage
-- **Comprehensive Tooling**: 71 development tools including test generation, scaffolding, and security scanning
-- **100% Agent Coverage**: All plugins include specialized agents
-- **Agent Skills**: 107 specialized skills following for progressive disclosure and token efficiency
-- **Clear Organization**: 23 categories with 1-6 plugins each for easy discovery
-- **Efficient Design**: Average 3.4 components per plugin (follows Anthropic's 2-8 pattern)
-
-### How It Works
-
-Each plugin is completely isolated with its own agents, commands, and skills:
-
-- **Install only what you need** - Each plugin loads only its specific agents, commands, and skills
-- **Minimal token usage** - No unnecessary resources loaded into context
-- **Mix and match** - Compose multiple plugins for complex workflows
-- **Clear boundaries** - Each plugin has a single, focused purpose
-- **Progressive disclosure** - Skills load knowledge only when activated
+```bash
+pip install skilz
+```
 
-**Example**: Installing `python-development` loads 3 Python agents, 1 scaffolding tool, and makes 5 skills available (~300 tokens), not the entire marketplace.
+This skill supports [Agent Skill Standard](https://agentskills.io/) which means it supports 14 plus coding agents including Claude Code, OpenAI Codex, Cursor and Gemini.
 
-## Quick Start
 
-### Step 1: Add the Marketplace
+### Git URL Options
 
-Add this marketplace to Claude Code:
+You can use either `-g` or `--git` with HTTPS or SSH URLs:
 
 ```bash
-/plugin marketplace add wshobson/agents
-```
-
-This makes all 67 plugins available for installation, but **does not load any agents or tools** into your context.
+# HTTPS URL
+skilz install -g https://github.com/wshobson/agents
 
-### Step 2: Install Plugins
+# SSH URL
+skilz install --git git@github.com:wshobson/agents.git
+```
 
-Browse available plugins:
+### Claude Code
 
+Install to user home (available in all projects):
 ```bash
-/plugin
+skilz install -g https://github.com/wshobson/agents
 ```
 
-Install the plugins you need:
-
+Install to current project only:
 ```bash
-# Essential development plugins
-/plugin install python-development          # Python with 5 specialized skills
-/plugin install javascript-typescript       # JS/TS with 4 specialized skills
-/plugin install backend-development         # Backend APIs with 3 architecture skills
-
-# Infrastructure & operations
-/plugin install kubernetes-operations       # K8s with 4 deployment skills
-/plugin install cloud-infrastructure        # AWS/Azure/GCP with 4 cloud skills
-
-# Security & quality
-/plugin install security-scanning           # SAST with security skill
-/plugin install code-review-ai             # AI-powered code review
-
-# Full-stack orchestration
-/plugin install full-stack-orchestration   # Multi-agent workflows
+skilz install -g https://github.com/wshobson/agents --project
 ```
 
-Each installed plugin loads **only its specific agents, commands, and skills** into Claude's context.
-
-## Documentation
-
-### Core Guides
-
-- **[Plugin Reference](docs/plugins.md)** - Complete catalog of all 67 plugins
-- **[Agent Reference](docs/agents.md)** - All 99 agents organized by category
-- **[Agent Skills](docs/agent-skills.md)** - 107 specialized skills with progressive disclosure
-- **[Usage Guide](docs/usage.md)** - Commands, workflows, and best practices
-- **[Architecture](docs/architecture.md)** - Design principles and patterns
-
-### Quick Links
-
-- [Installation](#quick-start) - Get started in 2 steps
-- [Essential Plugins](docs/plugins.md#quick-start---essential-plugins) - Top plugins for immediate productivity
-- [Command Reference](docs/usage.md#command-reference-by-category) - All slash commands organized by category
-- [Multi-Agent Workflows](docs/usage.md#multi-agent-workflow-examples) - Pre-configured orchestration examples
-- [Model Configuration](docs/agents.md#model-configuration) - Haiku/Sonnet hybrid orchestration
-
-## What's New
-
-### Agent Skills (107 skills across 18 plugins)
-
-Specialized knowledge packages following Anthropic's progressive disclosure architecture:
-
-**Language Development:**
-- **Python** (5 skills): async patterns, testing, packaging, performance, UV package manager
-- **JavaScript/TypeScript** (4 skills): advanced types, Node.js patterns, testing, modern ES6+
-
-**Infrastructure & DevOps:**
-- **Kubernetes** (4 skills): manifests, Helm charts, GitOps, security policies
-- **Cloud Infrastructure** (4 skills): Terraform, multi-cloud, hybrid networking, cost optimization
-- **CI/CD** (4 skills): pipeline design, GitHub Actions, GitLab CI, secrets management
-
-**Development & Architecture:**
-- **Backend** (3 skills): API design, architecture patterns, microservices
-- **LLM Applications** (4 skills): LangChain, prompt engineering, RAG, evaluation
-
-**Blockchain & Web3** (4 skills): DeFi protocols, NFT standards, Solidity security, Web3 testing
+### OpenCode
 
-**And more:** Framework migration, observability, payment processing, ML operations, security scanning
-
-[→ View complete skills documentation](docs/agent-skills.md)
-
-### Three-Tier Model Strategy
-
-Strategic model assignment for optimal performance and cost:
-
-| Tier | Model | Agents | Use Case |
-|------|-------|--------|----------|
-| **Tier 1** | Opus 4.5 | 42 | Critical architecture, security, ALL code review, production coding (language pros, frameworks) |
-| **Tier 2** | Inherit | 42 | Complex tasks - user chooses model (AI/ML, backend, frontend/mobile, specialized) |
-| **Tier 3** | Sonnet | 51 | Support with intelligence (docs, testing, debugging, network, API docs, DX, legacy, payments) |
-| **Tier 4** | Haiku | 18 | Fast operational tasks (SEO, deployment, simple docs, sales, content, search) |
-
-**Why Opus 4.5 for Critical Agents?**
-- 80.9% on SWE-bench (industry-leading)
-- 65% fewer tokens for complex tasks
-- Best for architecture decisions and security audits
-
-**Tier 2 Flexibility (`inherit`):**
-Agents marked `inherit` use your session's default model, letting you balance cost and capability:
-- Set via `claude --model opus` or `claude --model sonnet` when starting a session
-- Falls back to Sonnet 4.5 if no default specified
-- Perfect for frontend/mobile developers who want cost control
-- AI/ML engineers can choose Opus for complex model work
-
-**Cost Considerations:**
-- **Opus 4.5**: $5/$25 per million input/output tokens - Premium for critical work
-- **Sonnet 4.5**: $3/$15 per million tokens - Balanced performance/cost
-- **Haiku 4.5**: $1/$5 per million tokens - Fast, cost-effective operations
-- Opus's 65% token reduction on complex tasks often offsets higher rate
-- Use `inherit` tier to control costs for high-volume use cases
-
-Orchestration patterns combine models for efficiency:
-```
-Opus (architecture) → Sonnet (development) → Haiku (deployment)
+Install for [OpenCode](https://opencode.ai):
+```bash
+skilz install -g https://github.com/wshobson/agents --agent opencode
 ```
 
-[→ View model configuration details](docs/agents.md#model-configuration)
-
-## Popular Use Cases
-
-### Full-Stack Feature Development
-
+Project-level install:
 ```bash
-/full-stack-orchestration:full-stack-feature "user authentication with OAuth2"
+skilz install -g https://github.com/wshobson/agents --project --agent opencode
 ```
 
-Coordinates 7+ agents: backend-architect → database-architect → frontend-developer → test-automator → security-auditor → deployment-engineer → observability-engineer
-
-[→ View all workflow examples](docs/usage.md#multi-agent-workflow-examples)
-
-### Security Hardening
+### Gemini
 
+Project-level install for Gemini:
 ```bash
-/security-scanning:security-hardening --level comprehensive
+skilz install -g https://github.com/wshobson/agents --agent gemini
 ```
 
-Multi-agent security assessment with SAST, dependency scanning, and code review.
-
-### Python Development with Modern Tools
+### OpenAI Codex
 
+Install for OpenAI Codex:
 ```bash
-/python-development:python-scaffold fastapi-microservice
+skilz install -g https://github.com/wshobson/agents --agent codex
 ```
 
-Creates production-ready FastAPI project with async patterns, activating skills:
-- `async-python-patterns` - AsyncIO and concurrency
-- `python-testing-patterns` - pytest and fixtures
-- `uv-package-manager` - Fast dependency management
-
-### Kubernetes Deployment
-
+Project-level install:
 ```bash
-# Activates k8s skills automatically
-"Create production Kubernetes deployment with Helm chart and GitOps"
+skilz install -g https://github.com/wshobson/agents --project --agent codex
 ```
 
-Uses kubernetes-architect agent with 4 specialized skills for production-grade configs.
-
-[→ View complete usage guide](docs/usage.md)
-
-## Plugin Categories
-
-**23 categories, 67 plugins:**
 
-- 🎨 **Development** (4) - debugging, backend, frontend, multi-platform
-- 📚 **Documentation** (3) - code docs, API specs, diagrams, C4 architecture
-- 🔄 **Workflows** (3) - git, full-stack, TDD
-- ✅ **Testing** (2) - unit testing, TDD workflows
-- 🔍 **Quality** (3) - code review, comprehensive review, performance
-- 🤖 **AI & ML** (4) - LLM apps, agent orchestration, context, MLOps
-- 📊 **Data** (2) - data engineering, data validation
-- 🗄️ **Database** (2) - database design, migrations
-- 🚨 **Operations** (4) - incident response, diagnostics, distributed debugging, observability
-- ⚡ **Performance** (2) - application performance, database/cloud optimization
-- ☁️ **Infrastructure** (5) - deployment, validation, Kubernetes, cloud, CI/CD
-- 🔒 **Security** (4) - scanning, compliance, backend/API, frontend/mobile
-- 💻 **Languages** (7) - Python, JS/TS, systems, JVM, scripting, functional, embedded
-- 🔗 **Blockchain** (1) - smart contracts, DeFi, Web3
-- 💰 **Finance** (1) - quantitative trading, risk management
-- 💳 **Payments** (1) - Stripe, PayPal, billing
-- 🎮 **Gaming** (1) - Unity, Minecraft plugins
-- 📢 **Marketing** (4) - SEO content, technical SEO, SEO analysis, content marketing
-- 💼 **Business** (3) - analytics, HR/legal, customer/sales
-- And more...
+### Install from Skillzwave Marketplace
+```
+# Claude to user home dir ~/.claude/skills
+skilz install wshobson_agents/plugins__developer-essentials__skills__debugging-strategies
 
-[→ View complete plugin catalog](docs/plugins.md)
+# Claude skill in project folder ./claude/skills
+skilz install wshobson_agents/plugins__developer-essentials__skills__debugging-strategies --project
 
-## Architecture Highlights
+# OpenCode install to user home dir ~/.config/opencode/skills
+skilz install wshobson_agents/plugins__developer-essentials__skills__debugging-strategies --agent opencode
 
-### Granular Design
+# OpenCode project level
+skilz install wshobson_agents/plugins__developer-essentials__skills__debugging-strategies --agent opencode --project
 
-- **Single responsibility** - Each plugin does one thing well
-- **Minimal token usage** - Average 3.4 components per plugin
-- **Composable** - Mix and match for complex workflows
-- **100% coverage** - All 99 agents accessible across plugins
+# OpenAI Codex install to user home dir ~/.codex/skills
+skilz install wshobson_agents/plugins__developer-essentials__skills__debugging-strategies
 
-### Progressive Disclosure (Skills)
+# OpenAI Codex project level ./.codex/skills
+skilz install wshobson_agents/plugins__developer-essentials__skills__debugging-strategies --agent opencode --project
 
-Three-tier architecture for token efficiency:
-1. **Metadata** - Name and activation criteria (always loaded)
-2. **Instructions** - Core guidance (loaded when activated)
-3. **Resources** - Examples and templates (loaded on demand)
 
-### Repository Structure
+# Gemini CLI (project level) -- only works with project level
+skilz install wshobson_agents/plugins__developer-essentials__skills__debugging-strategies --agent gemini
 
 ```
-claude-agents/
-├── .claude-plugin/
-│   └── marketplace.json          # 67 plugins
-├── plugins/
-│   ├── python-development/
-│   │   ├── agents/               # 3 Python experts
-│   │   ├── commands/             # Scaffolding tool
-│   │   └── skills/               # 5 specialized skills
-│   ├── kubernetes-operations/
-│   │   ├── agents/               # K8s architect
-│   │   ├── commands/             # Deployment tools
-│   │   └── skills/               # 4 K8s skills
-│   └── ... (65 more plugins)
-├── docs/                          # Comprehensive documentation
-└── README.md                      # This file
-```
-
-[→ View architecture details](docs/architecture.md)
-
-## Contributing
-
-To add new agents, skills, or commands:
-
-1. Identify or create the appropriate plugin directory in `plugins/`
-2. Create `.md` files in the appropriate subdirectory:
-   - `agents/` - For specialized agents
-   - `commands/` - For tools and workflows
-   - `skills/` - For modular knowledge packages
-3. Follow naming conventions (lowercase, hyphen-separated)
-4. Write clear activation criteria and comprehensive content
-5. Update the plugin definition in `.claude-plugin/marketplace.json`
 
-See [Architecture Documentation](docs/architecture.md) for detailed guidelines.
+See this site [skill Listing](https://skillzwave.ai/skill/wshobson__agents__plugins__developer-essentials__skills__debugging-strategies__SKILL/) to see how to install this exact skill to 14+ different coding agents.
 
-## Resources
 
-### Documentation
-- [Claude Code Documentation](https://docs.claude.com/en/docs/claude-code/overview)
-- [Plugins Guide](https://docs.claude.com/en/docs/claude-code/plugins)
-- [Subagents Guide](https://docs.claude.com/en/docs/claude-code/sub-agents)
-- [Agent Skills Guide](https://docs.claude.com/en/docs/agents-and-tools/agent-skills/overview)
-- [Slash Commands Reference](https://docs.claude.com/en/docs/claude-code/slash-commands)
+### Other Supported Agents
 
-### This Repository
-- [Plugin Reference](docs/plugins.md)
-- [Agent Reference](docs/agents.md)
-- [Agent Skills Guide](docs/agent-skills.md)
-- [Usage Guide](docs/usage.md)
-- [Architecture](docs/architecture.md)
+Skilz supports 14+ coding agents including Claude Code, OpenAI Codex, OpenCode, Cursor, Gemini CLI, GitHub Copilot CLI, Windsurf, Qwen Code, Aidr, and more.
 
-## License
+For the full list of supported platforms, visit [SkillzWave.ai/platforms](https://skillzwave.ai/platforms/) or see the [skilz-cli GitHub repository](https://github.com/SpillwaveSolutions/skilz-cli)
 
-MIT License - see [LICENSE](LICENSE) file for details.
 
-## Star History
+<a href="https://skillzwave.ai/">Largest Agentic Marketplace for AI Agent Skills</a> and
+<a href="https://spillwave.com/">SpillWave: Leaders in AI Agent Development.</a>
 
-[![Star History Chart](https://api.star-history.com/svg?repos=wshobson/agents&type=date&legend=top-left)](https://www.star-history.com/#wshobson/agents&type=date&legend=top-left)