skills-router
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@skills-router find a skill for building a SaaS landing page"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Visão geral
Quem acumula dezenas ou centenas de skills paga por isso em toda sessão: cada cliente (Claude Code, Gemini CLI, Cursor...) carrega a descrição de todas elas no contexto, use ou não.
Este projeto troca esse custo fixo por uma busca. As skills saem das pastas dos clientes e vão para uma fonte única; o agente passa a enxergar nativamente só um orquestrador e as skills que você fixar, e busca o resto quando precisa.
Related MCP server: skill-router-mcp
Arquitetura e fluxo
São duas peças: a meta-skill diz ao agente quando e como buscar; o servidor MCP executa a busca e entrega o conteúdo.
flowchart LR
subgraph Clientes["Clientes de IA"]
CC["Claude Code"]
GC["Gemini CLI"]
CU["Cursor"]
OT["Codex / opencode / Antigravity"]
end
subgraph Nativo["Carregado em toda sessão"]
ORQ["skill-orchestrator"]
PIN["skills fixadas (--pin)"]
end
subgraph Router["Servidor MCP: skills-router"]
SRV["server.py (FastMCP)"]
IDX["indexer.py"]
end
subgraph Runtime["~/.ai-skills"]
SK[("skills/")]
DR[("drafts/")]
IX[("index.json")]
end
Clientes --> ORQ
Clientes --> PIN
ORQ -->|"search / get"| SRV
SRV --> IDX
IDX --> IX
IDX --> SK
SRV -->|"propose_skill_draft"| DR
DR -->|"promote_draft (aprovado)"| SK
PIN -.->|"symlink"| SK
ORQ -.->|"symlink"| SKO que acontece numa tarefa comum:
sequenceDiagram
actor U as Você
participant A as Agente
participant R as skills-router
participant F as ~/.ai-skills
U->>A: "Crie uma landing page para um SaaS"
A->>R: search_installed_skills("landing page saas")
R->>F: lê index.json (reindexa se algo mudou)
R-->>A: nome, descrição, tags, score
Note over A: Decide: reaproveitar, combinar ou apontar lacuna
A->>R: get_skill_content("landing-page-design")
R->>F: lê só o SKILL.md escolhido
R-->>A: conteúdo completo + arquivos de apoio
A-->>U: executa a tarefa seguindo a skillInício rápido
Requer uv e Python 3.10+.
git clone https://github.com/DyoneNunes/mcp-manage-router-skill.git
cd mcp-manage-router-skill
uv run skills-router init --dry-run # mostra o que seria feito, sem alterar nada
uv run skills-router init # executaDepois, reinicie os clientes para carregarem o servidor MCP e a nova lista de skills.
Oinit move as skills que já existem nas pastas dos seus clientes. Nada é apagado:
os originais vão para ~/.ai-skills/backups/<data>/ com um manifesto, e
skills-router restore desfaz tudo. Rode o --dry-run antes.
Para manter algumas skills nativas (aparecendo no menu / do cliente), fixe-as:
uv run skills-router init --pin minha-skill --pin outra-skillCria
~/.ai-skills/skillse~/.ai-skills/drafts.Instala a meta-skill em
~/.ai-skills/skills/skill-orchestrator/SKILL.md.Detecta os clientes instalados e importa as skills que eles já têm para a fonte única. Skills idênticas em vários clientes são importadas uma vez só.
Move os originais para
~/.ai-skills/backups/<data>/, com manifesto.Deixa na pasta de skills de cada cliente apenas symlinks para o orquestrador e para as skills fixadas.
Registra o servidor MCP
skills-routerna config global de cada cliente, com cópia de segurança do arquivo antes de editar.Instala as skills incluídas que você ainda não tiver.
Gera o
index.jsoninicial.
Itens que não são skills (pastas sem SKILL.md, diretórios ocultos) nunca são movidos. Se
dois clientes tiverem skills homônimas com conteúdo diferente, a primeira é mantida e a
outra vai para ~/.ai-skills/conflicts/ para você decidir.
Opção | Efeito |
| Só relata; não altera nada. |
| Mantém a skill nativa nos clientes (repetível). |
| A pasta do cliente vira symlink para |
| Restringe os clientes tratados. |
| Define o comando usado pelos clientes para subir o servidor. |
Cliente | Pasta de skills | Config MCP |
Claude Code |
|
|
Gemini CLI |
|
|
Cursor |
|
|
Codex CLI |
|
|
opencode |
|
|
Antigravity |
|
|
|
| não se aplica |
Prefere instalar como ferramenta global? Useuv tool install git+https://github.com/DyoneNunes/mcp-manage-router-skill e rode
skills-router init de qualquer lugar.
Tools do servidor MCP
Tool | O que faz |
| Busca por relevância no índice. Devolve só |
| Devolve o |
| Força a reindexação do diretório oficial. |
| Salva um rascunho somente em |
| Move o rascunho para |
A busca é por palavras-chave, não semântica. Como a maioria das skills é descrita em inglês, consultas em inglês costumam achar mais.
Meta-skill skill-orchestrator
Distribuída em templates/skill-orchestrator/SKILL.md
e instalada pelo init. Ela impõe três regras ao agente:
Gatilho. Em tarefas de desenvolvimento, arquitetura ou automação, buscar primeiro.
Gatekeeping. Reaproveitar uma skill existente; se nenhuma cobre sozinha, combinar duas ou três; só então apontar a lacuna e sugerir uma skill externa ou nova.
Human-in-the-loop. Propor skill nova apenas para tarefas com mais de três passos específicos e claramente reutilizáveis, pedindo confirmação antes do rascunho e de novo antes da promoção.
O servidor não tem como verificar que um humano aprovou opromote_draft. A garantia
vem das regras da meta-skill e do pedido de permissão do próprio cliente. Para promover
você mesmo, use skills-router promote NOME no terminal.
Skills incluídas
Além do orquestrador, o pacote traz skills prontas em templates/. O init
as copia para ~/.ai-skills/skills apenas se você ainda não tiver uma skill com o mesmo
nome, então uma versão sua nunca é sobrescrita. Elas não são fixadas: ficam disponíveis
pela busca, e você expõe com skills-router pin NOME se quiser.
Skill | O que faz |
Escolhe, redige e aplica a licença de um repositório: entrevista sobre o que permitir e proibir, detecta contradições como "MIT mas proibido vender", gera o |
Referência
skills-router status # runtime, total indexado, fixadas e links por cliente
skills-router search fastapi postgres
skills-router pin NOME # expõe uma skill nativamente
skills-router unpin NOME
skills-router drafts # rascunhos em quarentena
skills-router promote NOME # promoção feita por você, pelo terminal
skills-router reindex
skills-router restore # desfaz o init a partir do último backup
skills-router serve # sobe o servidor MCP em stdio~/.ai-skills/
├── skills/ fonte única de verdade (uma pasta por skill, com SKILL.md)
├── drafts/ quarentena de rascunhos aguardando aprovação humana
├── index.json cache leve: name, description, tags e path de cada skill
├── config.json preferências desta máquina (skills fixadas, clientes)
├── backups/ originais movidos pelo init + manifesto para o restore
└── conflicts/ versões divergentes de skills com o mesmo nomeDefina AI_SKILLS_HOME para usar outro diretório. Pacotes que agrupam sub-skills em
<pacote>/skills/<sub>/SKILL.md também são indexados.
uv sync
AI_SKILLS_HOME=/tmp/ai-skills-teste uv run skills-router status
uv run skills-router servePara testar o instalador sem tocar nas suas pastas, aponte HOME para um diretório
temporário:
export FAKE=$(mktemp -d)
HOME=$FAKE uv run skills-router init --dry-runPara inspecionar as tools sem um agente:
npx @modelcontextprotocol/inspector uv run skills-router servePrivacidade
O repositório não guarda nada sobre quem o usa:
Caminhos saem de
$HOMEou deAI_SKILLS_HOME.Preferências (skills fixadas, clientes) ficam em
~/.ai-skills/config.json.Autoria dos rascunhos é lida em tempo de execução do
git config --global user.nameou do usuário do sistema.index.json, rascunhos e backups nunca são versionados.
Licença
MIT + Commons Clause v1.0 © 2026 Dyone Andrade — contato@dyonedev.com.br
O código é aberto e gratuito, mas não pode ser vendido.
Pode | Não pode |
Usar gratuitamente, em casa ou dentro da sua empresa | Vender o software, no todo ou em parte |
Estudar, copiar e modificar | Cobrar por produto ou serviço cujo valor venha substancialmente dele (hospedagem, consultoria ou suporte pagos) |
Redistribuir gratuitamente, mantendo a licença e o copyright | Remover ou alterar o aviso de licença |
Por causa da restrição de venda, esta não é uma licença "open source" na definição da OSI; o termo correto é source-available. Para uso comercial fora desses termos, fale com o autor.
Available Tools
5 toolsget_skill_contentGet Skill ContentA
Lê o SKILL.md completo de UMA skill escolhida (use após search_installed_skills).
Inputs: skill_name (required). Returns: object
promote_draftPromote DraftA
Move drafts/<skill_name> para skills/ e reindexa. Exige aprovação humana explícita.
Inputs: skill_name (required). Returns: object
propose_skill_draftPropose Skill DraftA
Salva um RASCUNHO de skill em drafts//SKILL.md (nunca em skills/).
Só chame depois de o humano confirmar explicitamente que quer o rascunho.
content é o corpo em Markdown; um frontmatter enviado junto é mesclado.
Inputs: name (required), content (required), description (required). Returns: object
rebuild_indexRebuild IndexB
Força a reindexação completa do diretório oficial de skills.
Inputs: no named parameters. Returns: object
search_installed_skillsSearch Installed SkillsA
Busca skills instaladas por relevância e devolve só metadados resumidos + score.
Não carrega nenhum SKILL.md. Use palavras-chave da stack/tarefa (os metadados costumam estar em inglês) e faça mais de uma busca se a tarefa cruzar domínios.
Inputs: query (required), limit. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a clearly distinct action: search (discover), get content (read), rebuild (maintenance), propose draft (create), promote draft (publish). The descriptions even specify sequencing (use search before get, propose before promote), leaving no room for misselection.
All five tools follow a consistent snake_case verb_noun pattern: search_installed_skills, get_skill_content, rebuild_index, propose_skill_draft, promote_draft. No mixed conventions.
Five tools map cleanly onto the discover/read/maintain/draft/publish lifecycle of a skills router. Well within the ideal 3-15 range with no filler.
The core discovery and draft-promotion lifecycle is covered, but there is no discard/delete draft, edit-existing-skill, or list-drafts operation, so agents may hit dead ends when managing or reverting drafts.
Maintenance
Related MCP Connectors
Search and load AI agent skills. Free metadata; full content requires a Pro or Studio account.
Search your team's shared AI-skill library, get install commands, and save skills from your agent.
Search and load agent skills on demand from a shared skill store.
Find AI agent skills: public previews and source links. Read-only discovery; no account required.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables coding agents to search, recommend, and validate a stack of reusable skills from a local catalog, producing deterministic plans without modifying the project.1MIT
- AlicenseAqualityDmaintenanceIndexes installed SKILL.md files and provides deterministic search and recommendation tools to help AI agents select relevant skills without executing them.428 npm1MIT
- AlicenseBqualityCmaintenanceEnables read-only access to a local-first catalog of portable agent skills, exposing tools to discover ranked matches, inspect stored artifacts, traverse declared relationships, and view configuration.5MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI coding agents to discover relevant reusable skills and external servers through read-only search, with concise paginated results and detail lookup before anything is installed.1MIT