MIDDAG Agent Skills

Skills, modos de trabalho e adaptadores MIDDAG para agentes de IA — instalados uma vez no usuário e expostos a Claude Code, Codex, Google Antigravity, Cursor e Gemini CLI por links, sem copiar arquivo por repositório.

• Pacote: @middag-io/agent-skills (NPM público, perfil standard)
• Binário: mdg-agent-skills
• Perfil managed: @middag-io/agent-skills-managed (GitHub Packages, opt-in, autenticado)

Status

BETA — canal beta do pacote (npm install -g @middag-io/agent-skills@beta; até o 0.1.0 stable, latest também resolve para a BETA atual). Primeira BETA publicada e verificada em 2026-09-05: docs/release/2026-09-05-beta-release-report.md. Duas coisas são distribuídas e versionadas de forma independente:

• o pacote (CLI + instalador + fallback offline de skills, modos e adaptadores) — NPM público e GitHub Releases;
• o catálogo de artefatos (skills, modos, adaptadores, recomendações; artifacts/catalog.yaml, schema em schema/) — tarballs imutáveis com checksum no bucket público MIDDAG, canais beta/rc/stable, servidos a mdg-agent-skills sync.

As skills embutidas no pacote são só o fallback offline da data de build. A atualização normal de skills, modos, adaptadores e recomendações vem do catálogo publicado (sync), sem trocar a CLI. Enquanto um canal do catálogo não tiver conteúdo publicado, sync e recommendations avisam que a fonte está indisponível e a instalação segue com o fallback.

Catálogo: docs/reference/catalog.md. Matriz de ferramentas (o que foi de fato verificado, por ferramenta): docs/reference/tools-matrix.md. CLI: docs/reference/cli.md. Sincronização: docs/how-to/sync-artifacts.md.

Instalação

npm install -g @middag-io/agent-skills@beta
mdg-agent-skills doctor          # detecta ferramentas e diretórios
mdg-agent-skills install         # links por ferramenta detectada (fallback embutido)
mdg-agent-skills sync --channel beta   # skills/modos/adaptadores do catálogo público MIDDAG
mdg-agent-skills recommendations --channel beta   # ferramentas e integrações recomendadas (só leitura)
mdg-agent-skills status

Fonte canônica em ~/.middag-agent-skills/; cada ferramenta recebe ~/.<tool>/skills/<id> apontando para lá. Nada do usuário é sobrescrito sem confirmação; toda mutação tem backup e rollback (sync --rollback para artefatos, rollback para a instalação).

Layout

skills/          capacidades portáveis (SKILL.md)        mdg-discovery, mdg-audit, mdg-handoff
modes/           contratos de modo (MODE.md)             discovery, audit, handoff + 4 contract-only
adapters/        formato e paths por ferramenta
integrations/    middagctl, mdgstan, vigim, github, mcp  detecção e leitura declarada
profiles/        standard (público) e managed (opt-in)
compatibility/   matriz verificada de suporte por ferramenta
src/ bin/        instalador e CLI (Node >= 20, ESM)
docs/            decisões (AGS-*), referência e how-to

Princípios

• Método (VIGIM) é portável; nenhuma ferramenta redefine sua semântica (AGS-001).
• Git é fonte de verdade; NPM, GitHub Packages e GitHub Releases são canais (AGS-002).
• Instalação por link, por capability, com backup, rollback e diagnóstico (AGS-003).
• Integrações são capabilities declaradas, nunca dependência obrigatória; MCP privado só em managed (AGS-004).
• Nenhuma ferramenta é native sem teste real registrado em compatibility/tools.yaml.

Desenvolvimento

npm ci
npm test            # node --test, instalação em mktemp
npm run check       # lint + typecheck + validação de manifesto/skills + scans

Documentação em PT-BR; código, mensagens de erro e SKILL.md em inglês.