convez.ai
SkillDevOps & InfraestruturaAvançado
quangtran88

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 GitHub
InicialPluginScore · de 0 a 100

Suite 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-skills

1 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

Estrelas
5
Forks
1
Acompanhando
0
Saúde
28%
Último commit
há 1 mês
Versão
v2.7.0
Issues abertas
0
Contribuidores
1

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 gracio­sos 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 gemini CLI detection for the x-gemini skill)

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

SkillInvokeWhat it does
x-do/x-skills:x-doUniversal 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-researchUniversal research router — classifies questions and routes to optimal agents (codebase search, external docs, architecture review, OSS internals, pre-planning)
x-review/x-skills:x-reviewCode/plan/PR review orchestrator — cross-model review with Claude + GPT perspectives, structured verdicts
x-verify/x-skills:x-verifyCompletion-cascade dispatcher — answers "am I done?" for long-running skills with mandatory fallback to prevent silent success claims
x-bugfix/x-skills:x-bugfixStructured debugging — routes through investigation, hypothesis testing, and verified fix with evidence collection
x-mindful/x-skills:x-mindfulPre-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-designVisual 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-pentestAPI security testing — OWASP API Top 10 testing with schemathesis, nuclei, sqlmap, spectral
x-qa/x-skills:x-qaProfile-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-teamMulti-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-worktreeIsolated 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-isolatePer-worktree docker-compose isolation — scan once, emit profile.json, write compose.override.yml + .env.worktree per new worktree
x-omo/x-skills:x-omoOpenCode multi-model bridge — dispatch to GPT-5.5, Gemini, Codex models via role agents or direct model routing
x-gemini/x-skills:x-geminiDirect 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-guideProgressive 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-improveSession-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:

  1. Reads ~/.config/x-skills/capabilities.json to detect available tools
  2. Classifies the user's request into a type/mode
  3. 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.

DependencyWhat it enablesInstall
OpenCodeMulti-model dispatch (GPT, Gemini, Codex)curl -fsSL https://opencode.ai/install | bash
Gemini CLIDirect Gemini access for x-gemini (Google Search grounding, gemini-3.x)npm install -g @google/gemini-cli
oh-my-openagentRole agents (oracle, explore, librarian)opencode plugin oh-my-openagent
oh-my-claudecodeOMC agents (executor, code-reviewer, debugger)/plugin marketplace add Yeachan-Heo/oh-my-claudecode
superpowersWorkflow skills (brainstorming, TDD, writing-plans)/plugin marketplace add obra/superpowers-marketplace
MCP serversperplexity, deepwiki, exa, context7Configure in .mcp.json
Security toolsschemathesis, nuclei, sqlmap, spectralpip install schemathesis sqlmap / brew install nuclei

Capability Tiers

TierWhat you haveSkill capability
FullOpenCode + oh-my-openagent + OMC + superpowers + MCP serversMulti-model routing, cross-model review, full agent catalog
Claude+PluginsOMC + superpowers (no OpenCode)Claude-only routing with OMC agents and workflow skills
BareJust x-skillsClaude-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

Ver o original no GitHub

Bom para

Relacionados