X-Skills — Roteador Inteligente de Habilidades para Claude Code
quangtran88/x-skills
Roteador inteligente de tarefas dev com orquestração multi-modelo e fallbacks automáticos
Ver no GitHubSuite de habilidades especializadas que classifica intenção do usuário e roteia para o executor ótimo. Cobre execução, pesquisa, revisão, debugging, design e testes de segurança, com orquestração multi-modelo opcional via OpenCode. Degrada graciosamente para modo Claude-only quando ferramentas externas não estão disponíveis.
Instalação
npx convez-ai quangtran88/x-skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Executar tarefas de desenvolvimento classificadas automaticamente (novas features, bugfixes, refatorações)
- Pesquisa estruturada em codebase, documentação externa e arquitetura OSS
- Revisão cruzada de código e PRs com múltiplos modelos (Claude + GPT)
- Debugging estruturado com hipótese testada e coleta de evidências
- Testes de segurança API (OWASP Top 10) com schemathesis, nuclei, sqlmap
- Orquestração paralela de múltiplas features com isolamento git worktree
Veredito

Ferramenta robusta e modular para equipes que precisam de automação sofisticada em fluxo de desenvolvimento. Arquitetura com roteamento inteligente e fallbacks graciosos reduz riscos — mas exige setup cuidadoso e manutenção de dependências opcionais. Vale para projetos complexos com múltiplas fases paralelas.
README
A tradução para o português deste README ainda está na fila.
x-skills
Intelligent skill routers for Claude Code. Each skill classifies user intent and routes to the optimal executor — with optional multi-model orchestration via OpenCode.
All dependencies are optional. Skills degrade gracefully to Claude-only mode when external tools aren't available.
Install
/plugin marketplace add quangtran88/x-skills
/plugin install x-skills@x-skills-marketplace
/reload-plugins
Then run setup to configure the bindings (omo-agent, agy-agent) and detect available dependencies:
/x-skills:setup
Upgrading
After every plugin upgrade, re-run /x-skills:setup. It refreshes:
- Symlinks (
~/.local/bin/omo-agent,~/.local/bin/agy-agent) to point at the new plugin cache ~/.config/x-skills/capabilities.json(new fields appear with each release)- Detection of newly-supported dependencies (e.g. v1.4.0 added
geminiCLI detection for thex-geminiskill)
The plugin's SessionStart hook detects stale capabilities and reminds you, but you can run /x-skills:setup proactively any time — it's idempotent.
Skills
| Skill | Invoke | What it does |
|---|---|---|
| x-do | /x-skills:x-do | Universal execution router — classifies tasks into modes (new feature, bugfix, quick edit, refactor, plan execution) and dispatches to the right workflow |
| x-research | /x-skills:x-research | Universal research router — classifies questions and routes to optimal agents (codebase search, external docs, architecture review, OSS internals, pre-planning) |
| x-review | /x-skills:x-review | Code/plan/PR review orchestrator — cross-model review with Claude + GPT perspectives, structured verdicts |
| x-verify | /x-skills:x-verify | Completion-cascade dispatcher — answers "am I done?" for long-running skills with mandatory fallback to prevent silent success claims |
| x-bugfix | /x-skills:x-bugfix | Structured debugging — routes through investigation, hypothesis testing, and verified fix with evidence collection |
| x-mindful | /x-skills:x-mindful | Pre-implementation architect-review gate — walks the user through the tradeoffs AI silently picked, assumptions it baked in, blind spots, over/under-engineering, and future-debt at architect level (never code-level), one item at a time |
| x-design | /x-skills:x-design | Visual design system integration — resolves brand references (Linear-like, Stripe-like) to curated DESIGN.md files from 58 indexed sites |
| x-api-pentest | /x-skills:x-api-pentest | API security testing — OWASP API Top 10 testing with schemathesis, nuclei, sqlmap, spectral |
| x-qa | /x-skills:x-qa | Profile-driven E2E QA — scans the project once, persists a launch/test profile, fans tests out across cheap/strong models against an isolated stack |
| x-team | /x-skills:x-team | Multi-feature team orchestrator — decomposes work into N parallel features, provisions a worktree per feature, gates merges on x-qa passing |
| x-worktree | /x-skills:x-worktree | Isolated git worktree provisioner — used by x-do/x-bugfix --wt flag and directly; auto-applies docker-compose isolation when a profile is present |
| x-worktree-isolate | /x-skills:x-worktree-isolate | Per-worktree docker-compose isolation — scan once, emit profile.json, write compose.override.yml + .env.worktree per new worktree |
| x-omo | /x-skills:x-omo | OpenCode multi-model bridge — dispatch to GPT-5.5, Gemini, Codex models via role agents or direct model routing |
| x-gemini | /x-skills:x-gemini | Direct Gemini CLI bridge — uses Google Ultra subscription (no API key), native Google Search grounding, gemini-3.x access without OpenCode layer |
| x-guide | /x-skills:x-guide | Progressive comprehension-gated tutor — turns docs/PRDs/specs/code/features into a resumable walkthrough with per-project state in .x-guide/<slug>/ |
| x-skill-improve | /x-skills:x-skill-improve | Session-based skill alignment analyzer — evaluates how well a skill was followed during real sessions and proposes targeted edits |
x-shared is a reference library used by other skills (not invokable directly).
How It Works
Each skill is a router, not an executor. It:
- Reads
~/.config/x-skills/capabilities.jsonto detect available tools - Classifies the user's request into a type/mode
- Dispatches to the best available executor (OMO agent, OMC agent, native Claude agent, or direct tool)
User: "add auth to the API"
│
x-do classifies → Mode A (new feature)
│
┌────┴────────────────────┐
│ opencode available? │
├─── yes ─→ OMO oracle │ (oracle review)
│ + OMC executor │ (Claude implementation)
├─── no ──→ Agent(opus) │ (Claude-only fallback)
└─────────────────────────┘
Dependencies
Everything is optional. Setup detects what's available and skills adapt.
| Dependency | What it enables | Install |
|---|---|---|
| OpenCode | Multi-model dispatch (GPT, Gemini, Codex) | curl -fsSL https://opencode.ai/install | bash |
| Gemini CLI | Direct Gemini access for x-gemini (Google Search grounding, gemini-3.x) | npm install -g @google/gemini-cli |
| oh-my-openagent | Role agents (oracle, explore, librarian) | opencode plugin oh-my-openagent |
| oh-my-claudecode | OMC agents (executor, code-reviewer, debugger) | /plugin marketplace add Yeachan-Heo/oh-my-claudecode |
| superpowers | Workflow skills (brainstorming, TDD, writing-plans) | /plugin marketplace add obra/superpowers-marketplace |
| MCP servers | perplexity, deepwiki, exa, context7 | Configure in .mcp.json |
| Security tools | schemathesis, nuclei, sqlmap, spectral | pip install schemathesis sqlmap / brew install nuclei |
Capability Tiers
| Tier | What you have | Skill capability |
|---|---|---|
| Full | OpenCode + oh-my-openagent + OMC + superpowers + MCP servers | Multi-model routing, cross-model review, full agent catalog |
| Claude+Plugins | OMC + superpowers (no OpenCode) | Claude-only routing with OMC agents and workflow skills |
| Bare | Just x-skills | Claude-only fallback — skills still work using native Agent tool |
Setup
/x-skills:setup detects your environment and offers to install missing dependencies:
$ /x-skills:setup
Working: omo-agent, opencode (166 models), perplexity MCP
Missing: oh-my-claudecode, superpowers
Would you like me to install the missing plugins? [1,2,3 / all / skip]
Setup is idempotent — safe to run any number of times. Each run detects current state and only acts on what's missing.
Manual Setup
If you prefer to set up manually:
# The bin/ directory is auto-added to PATH when the plugin is enabled
# omo-agent is available immediately after install
# Run the setup script directly to generate capabilities manifest
~/.claude/plugins/cache/x-skills-marketplace/x-skills/*/bin/setup
# Or with --check for read-only detection
~/.claude/plugins/cache/x-skills-marketplace/x-skills/*/bin/setup --check
Plugin Structure
x-skills/
├── .claude-plugin/
│ ├── plugin.json # Plugin manifest
│ └── marketplace.json # Marketplace registration
├── bin/
│ ├── omo-agent # OpenCode multi-model wrapper
│ ├── setup # Setup script (binding + detection)
│ └── find-plugin-dir # Plugin path resolver
├── commands/
│ └── setup.md # /x-skills:setup command
├── lib/
│ └── feature-gate.md # Fallback routing reference
├── skills/
│ ├── x-do/ # Execution router
│ ├── x-research/ # Research router
│ ├── x-review/ # Review orchestrator
│ ├── x-verify/ # Completion cascade
│ ├── x-bugfix/ # Debugging workflow
│ ├── x-mindful/ # Pre-implementation impact gate
│ ├── x-design/ # Design system integration
│ ├── x-api-pentest/ # API security testing
│ ├── x-qa/ # Profile-driven E2E QA
│ ├── x-team/ # Multi-feature team orchestrator
│ ├── x-worktree/ # Isolated git worktree provisioner
│ ├── x-worktree-isolate/ # Per-worktree docker-compose isolation
│ ├── x-omo/ # OpenCode bridge
│ ├── x-gemini/ # Direct Gemini CLI bridge
│ ├── x-guide/ # Progressive comprehension-gated tutor
│ ├── x-skill-improve/ # Session-based skill alignment analyzer
│ └── x-shared/ # Shared references
├── CLAUDE.md # Plugin instructions
└── package.json
Development
Test locally without installing:
claude --plugin-dir ./x-skills
Run setup in check mode (no modifications):
./bin/setup --check
License
MIT