Blog · Guia · 29 de outubro de 2026

Importe um SKILL.md da comunidade como agente do AEGIS

Também em: English, Español, 日本語, Deutsch, Français, 한국어, 简体中文, Italiano, हिन्दी · Todos os guias em português

Aviso: a 100monkeys.ai desenvolve o AEGIS, então leia este guia como o relato de quem o fabrica. Ele foi redigido por um dos nossos agentes de IA a partir da documentação pública do AEGIS, principalmente Importing Community Skills, com a CLI Reference, a Workflow Manifest Reference e a Configuration Reference, e revisado pela empresa; esta versão em português é uma tradução do guia original em inglês. Cada comando abaixo foi copiado dessas páginas, e nenhum foi executado para este guia. As citações ficam em inglês com a tradução ao lado. Onde a documentação deixa uma pergunta em aberto, a última seção diz isso.

AEGIS by 100monkeys.ai, in beta, pode transformar uma skill da comunidade, um arquivo SKILL.md de um repositório público, num agente que você pode executar. Ele não busca a skill em tempo de execução. A documentação descreve a importação como "an explicit, auditable pipeline with human review" (um pipeline explícito e auditável com revisão humana): o arquivo é baixado uma vez, verificado por um agente validador, transformado num manifesto, retido até a sua aprovação e só então registrado. Este guia percorre esse pipeline do comando até o novo agente.

Passo 1. Confirme que o workflow está no seu nó

skill-import é um dos templates embutidos. A Configuration Reference o lista em deploy_builtins, junto com o agente skill-validator de que ele depende:

# Deploy vendored built-in agent and workflow templates on startup.
# Includes agent-creator-agent, workflow-generator-planner-agent, judge agents,
# intent-executor-discovery-agent, intent-result-formatter-agent, skill-validator,
# and the builtin-workflow-generator, builtin-intent-to-execution, skill-import, the-forge and
# transcribe-audio workflows, with the Forge's seven agents.
# Required for aegis.agent.generate, aegis.workflow.generate, and aegis.execute.intent to function.
# Default: false
deploy_builtins: false

O padrão é false, então num nó novo defina true em aegis-config.yaml antes de procurar o workflow. Depois, aegis workflow list mostra o que está registrado.

Passo 2. Conheça os seis estados antes de começar

A documentação dá o pipeline numa linha:

FETCH → PARSE_AND_VALIDATE → COMPOSE_MANIFEST → REVIEW → REGISTER → COMPLETE

FETCH baixa o arquivo, e PARSE_AND_VALIDATE e COMPOSE_MANIFEST são estados Agent. REVIEW é um estado Human, o "Approval gate before registration" (portão de aprovação antes do registro), e REGISTER "Deploys the composed agent manifest" (implanta o manifesto de agente composto). Nada é registrado antes de REVIEW.

Passo 3. Escolha o arquivo da skill e um nome

A única entrada obrigatória é skill_url, uma "URL to a raw SKILL.md file (GitHub raw URL, registry URL, or any HTTP endpoint)" (URL de um arquivo SKILL.md bruto: URL raw do GitHub, URL de um registro ou qualquer endpoint HTTP). Aponte para o arquivo bruto, não para a página do repositório que o exibe. Se quiser o agente com um nome seu em vez do nome declarado pela skill, acrescente agent_name_override.

Passo 4. Escolha o preset de segurança

A terceira entrada, security_preset, define a política de segurança do agente gerado. A documentação lista dois valores:

minimal, o padrão: rede com tudo negado, sistema de arquivos somente leitura, e recursos de 500m de CPU, 256Mi de memória e um tempo limite de 5m.
permissive: rede liberada para os hosts que as ferramentas da skill declaram, leitura em /data, e 1000m de CPU, 512Mi de memória e um tempo limite de 10m.

Comece com minimal e conceda permissive só a uma skill cujas ferramentas você leu.

Passo 5. Execute a importação

O exemplo da documentação, com um nome próprio:

aegis workflow run skill-import --input '{
  "skill_url": "https://raw.githubusercontent.com/anthropics/skills/main/doc-coauthoring/SKILL.md",
  "agent_name_override": "doc-writer"
}'

E com o preset permissivo:

aegis workflow run skill-import --input '{
  "skill_url": "https://raw.githubusercontent.com/org/skills/main/data-analysis/SKILL.md",
  "security_preset": "permissive"
}'

A CLI Reference acrescenta --follow para acompanhar os logs do workflow e --wait para bloquear até que ele termine. Guarde o id de execução que a execução imprime; você precisa dele no portão de revisão.

Passo 6. Leia o que o validador verificou

Antes do portão humano, o agente skill-validator verifica a skill. A documentação lista o que ele procura: tentativas de injeção de prompt e de jailbreak, instruções que pedem para contornar controles de segurança, padrões de exfiltração de dados e referências a caminhos internos do sistema. Ele também avalia a qualidade e a coerência das instruções, que "must score above 0.7" (precisam pontuar acima de 0.7). Uma skill reprovada "is rejected before reaching the human review stage" (é rejeitada antes de chegar à revisão humana), então uma execução que nunca chega a REVIEW foi parada por este estado. aegis workflow executions get com o id de execução mostra o status atual e o blackboard da execução.

Passo 7. Revise o manifesto composto

Em REVIEW o workflow espera por você. A documentação diz o que o manifesto composto contém, que é o que você aprova:

metadados do frontmatter do SKILL.md (nome, descrição, rótulos);
os rótulos source: skill-import e skill-origin: community, "for traceability" (para rastreabilidade);
uma instrução de tarefa com o corpo completo de instruções da skill;
ferramentas tiradas do campo allowed-tools da skill e convertidas ao formato de ferramentas MCP do AEGIS;
a política de segurança do preset que você escolheu;
uma estratégia de execução de uma única tentativa: mode: one-shot, com max_retries: 1.

Leia a lista de ferramentas contra o preset. O validador avalia as instruções; é a sua revisão que decide se esta skill deve ter essas ferramentas.

Passo 8. Aprove ou rejeite

Para registrar o agente:

aegis workflow signal <execution-id> --response "approve"

Para pará-lo:

aegis workflow signal <execution-id> --response "reject"

A Workflow Manifest Reference lista "approve" entre as respostas que a condição input_equals_yes aceita e "reject" entre as de input_equals_no. Com a aprovação, REGISTER implanta o manifesto e COMPLETE o confirma.

Passo 9. Encontre o agente depois

Como todo agente importado leva source: skill-import e skill-origin: community, esses rótulos são a forma de separar os agentes vindos da comunidade dos que a sua equipe escreveu, numa lista hoje ou numa auditoria depois. aegis agent list lista os agentes do nó.

O que a documentação deixa em aberto

Palavras do portão. Esta página envia "approve" e "reject". A Workflow Manifest Reference aceita ambas; a página Human Approvals lista yes, y e 1. A página de importação não diz qual lista o estado REVIEW usa.
Comentário ao rejeitar. A página diz "Or reject with feedback" (ou rejeite com comentário), mas o comando envia só "reject"; como anexar o comentário não é mostrado.
O tempo de espera da revisão. A página não diz quanto tempo REVIEW espera nem o que acontece se ninguém responder.
Onde ler o manifesto composto. A página lista o que o manifesto contém, mas não o comando que o mostra ao revisor antes do sinal.
Filtrar por rótulo. A CLI Reference mostra --label para aegis workflow list, não para aegis agent list.
Reimportar. Nada diz o que acontece quando a mesma skill é importada duas vezes, ou quando o arquivo de origem muda depois.

O estado REVIEW é um estado Human comum, e você pode pôr o mesmo portão em qualquer workflow que escrever. Nosso guia Como dar a um orquestrador uma etapa de aprovação percorre um. O AEGIS se instala com o comando mostrado em 100monkeys.ai:

curl -fsSL https://get.100monkeys.ai | bash

Instale o AEGIS pelo 100monkeys.ai