equipping-stack-docs

Plugin/skill para agentes de código que gera, na hora certa, skills de documentação locais ao projeto com docs na versão que o projeto realmente usa — via Context7 (API REST anônima, sem MCP, sem API key).

O conhecimento de treino do modelo sobre frameworks desatualiza rápido — e falha mais forte em sistemas legados, onde o modelo escreve os idiomas de hoje contra as APIs de ontem. Este plugin resolve os dois lados: stacks novas (docs atuais da versão exata) e legados (docs da versão antiga, com anotações de delta baseadas em evidência).

• Instalação
• O que funciona em cada agente
• Como funciona
• Quando dispara
• Uso como skill avulsa (qualquer agente)
• Compatibilidade e requisitos

A instalação muda conforme o agente. Se você usa mais de um, instale em cada um separadamente.

Repositórios privados. Todos os repos da Framework System são privados. Qualquer comando abaixo que busque pela URL exige que você já esteja autenticado no GitHub (gh auth login, credential helper ou chave SSH no ssh-agent). Sem isso o download falha com erro de autenticação, não de "não encontrado".

Entrega completa: skill, comandos de barra e templates.

• Registre o marketplace:

  /plugin marketplace add Framework-System/frwk-plugins

• Instale o plugin:

  /plugin install equipping-stack-docs@frwk-plugins

O Copilot CLI lê o mesmo marketplace.json do Claude Code.

• Registre o marketplace:

  copilot plugin marketplace add Framework-System/frwk-plugins

• Instale o plugin:

  copilot plugin install equipping-stack-docs@frwk-plugins

O Copilot descobre skills por diretório. Copie a skill para o repositório onde vai trabalhar:

mkdir -p .agents/skills
cp -R /caminho/para/equipping-stack-docs/skills/equipping-stack-docs .agents/skills/

Ou para o diretório pessoal, valendo em todos os projetos: ~/.copilot/skills/.

O repositório traz .codex-plugin/plugin.json com a skill declarada. O plugin não está publicado no marketplace oficial do Codex — instale a partir do repositório clonado, ou copie a skill:

mkdir -p ~/.agents/skills
cp -R /caminho/para/equipping-stack-docs/skills/equipping-stack-docs ~/.agents/skills/

No Codex a skill é acionada por $equipping-stack-docs ou pela descrição dela.

Testado com o Cursor Agent 2026.08.11. O Cursor lê o mesmo marketplace.json do Claude Code, mas exige a URL completa — o atalho owner/repo é recusado com Invalid URL format.

cursor-agent login
cursor-agent plugin marketplace add github.com/Framework-System/frwk-plugins

O registro vale para a conta e o Cursor já clona os repositórios no ato. A ativação de cada plugin é feita no app: o CLI só tem plugin marketplace.

• Registre o marketplace:

  droid plugin marketplace add https://github.com/Framework-System/frwk-plugins

• Instale o plugin:

  droid plugin install equipping-stack-docs@frwk-plugins

• Instale a extensão:

  gemini extensions install https://github.com/Framework-System/equipping-stack-docs

• Atualize depois:

  gemini extensions update equipping-stack-docs

A extensão injeta o GEMINI.md, que inclui o conteúdo da skill no contexto da sessão.

O manifesto .kimi-plugin/plugin.json declara a skill.

/plugins install https://github.com/Framework-System/equipping-stack-docs

agy plugin install https://github.com/Framework-System/equipping-stack-docs

O OpenCode descobre skills por diretório. Testado com o OpenCode 1.18.21. Clone o repositório e declare o caminho no opencode.json do seu projeto — note que skills é um objeto com paths, não uma lista:

{
  "$schema": "https://opencode.ai/config.json",
  "skills": { "paths": ["/caminho/para/equipping-stack-docs/skills"] }
}

Confira com opencode debug skill. O OpenCode não recarrega config a quente: reinicie depois de editar.

pi install git:github.com/Framework-System/equipping-stack-docs

A skill segue o formato aberto Agent Skills. Copie skills/equipping-stack-docs/ para o diretório de skills do seu agente — os caminhos mais comuns são .agents/skills/ (no repositório) e ~/.agents/skills/ (pessoal).

Sem descoberta automática de skills, cole o conteúdo de skills/equipping-stack-docs/SKILL.md no contexto do agente (AGENTS.md, arquivo de instruções do projeto, system prompt) e peça: "siga a skill equipping-stack-docs".

Testado de verdade com o GitHub Copilot CLI 1.0.80 e com o validador de referência da spec (skills-ref), não inferido da documentação.

O padrão aberto Agent Skills cobre SKILL.md + scripts/ + references/ + assets/. O Copilot CLI vai além e também importa commands/ — mas num espaço de nomes plano, sem o prefixo do plugin.

Este plugin não tem comandos de barra: ele é só a skill. Em qualquer agente, incluindo o Claude Code, o acionamento é o mesmo — descreva o que quer e o agente carrega a skill pela descrição dela.

1. Descobre a stack em cascata: design aprovado → manifestos (package.json, pom.xml, go.mod...) → inferência do código (imports, jars, web.xml, script tags — versão marcada como aproximada).
2. Confirma com você a lista (tecnologia, versão real do projeto, fonte) antes de gastar qualquer chamada.
3. Despacha um subagente por tecnologia, cada um consultando a API anônima do Context7 e destilando uma skill de ~150 linhas em .claude/skills/<tech>-<major>-docs/ do seu projeto.
4. Versões antigas: escada de resolução (versão exata → vizinha de mesmo major → docs latest em modo delta). Anotações [not in 2.x] só entram com evidência nas próprias docs baixadas (guias de migração, notas "since v") — nunca da memória de treino. Distância grande demais → variante query-only honesta (version-gap).
5. As skills geradas são versionadas no git do seu projeto e disparam automaticamente quando qualquer agente futuro tocar código daquela stack.

Falha do Context7 nunca bloqueia seu fluxo — degradação é sempre para variantes honestas, nunca para silêncio ou docs enganosas.

• Com design/spec aprovado: após o refinamento do design, antes do plano de implementação — o plano já nasce referenciando as doc skills geradas.
• Autônomo em codebase existente: ao começar trabalho substancial (feature, mudança multi-arquivo) num projeto cuja stack não tem doc skills locais. Hotfix trivial não interrompe — guarda anti-ruído explícita.

Não precisa de sistema de plugins. A skill é um único arquivo Markdown auto-suficiente — o template do subagente, a escada de versão e o tratamento de erros estão todos embutidos nele:

git clone https://github.com/Framework-System/equipping-stack-docs.git
# skill só deste projeto:
cp -r equipping-stack-docs/skills/equipping-stack-docs SEU_PROJETO/.claude/skills/
# ou pessoal, para todos os projetos (Claude Code):
cp -r equipping-stack-docs/skills/equipping-stack-docs ~/.claude/skills/

Em harnesses sem descoberta automática de skills, cole o conteúdo de skills/equipping-stack-docs/SKILL.md no contexto do agente (arquivo de instruções do projeto, AGENTS.md, system prompt) e peça: "siga a skill equipping-stack-docs". Requisitos mínimos do ambiente: executar curl, criar arquivos e — idealmente — despachar subagentes; sem subagentes, o próprio agente executa o template de geração para uma tecnologia por vez.

• Context7: acesso anônimo, sem cadastro e sem API key — decisão de design. O rate limit anônimo é baixo; a skill economiza chamadas (confirmação antes de gerar, reaproveitamento de skills existentes, backoff em 429).
• Fluxos de planejamento: se o ambiente tiver uma skill de planos de implementação (ex.: writing-plans), o passo final a invoca informando quais doc skills existem; sem ela, o plugin reporta as skills geradas e devolve o controle. Funciona sozinho.
• Testado de ponta a ponta contra a API real do Context7 nos cenários: stack nova com versão exata, legado com versão vizinha (Spring Boot 2.1), legado sem manifesto (inferência de Struts por web.xml/jar), e AngularJS 1.x (resolução do repo arquivado correto, sem vazamento de Angular moderno).