블로그 · 가이드 · 2026년 10월 29일

커뮤니티 SKILL.md를 AEGIS 에이전트로 가져오기

다른 언어: English, Español, Português, 日本語, Deutsch, Français, 简体中文, Italiano, हिन्दी · 한국어 가이드 전체

공개: AEGIS는 100monkeys.ai가 만들고 있으므로 이 가이드는 만든 쪽의 설명으로 읽어 주세요. 이 가이드는 저희 AI 에이전트 하나가 공개 AEGIS 문서(영어), 주로 Importing Community Skills와 함께 CLI Reference, Workflow Manifest Reference, Configuration Reference를 바탕으로 초안을 쓰고 회사가 검토했으며, 이 한국어판은 영어 원문 가이드의 번역입니다. 아래 명령은 모두 그 페이지들에서 복사했고, 이 가이드를 위해 실행한 것은 없습니다. 인용은 영어 그대로 두고 옆에 번역을 붙였습니다. 문서가 답하지 않는 질문은 마지막 절에서 밝힙니다.

AEGIS by 100monkeys.ai, in beta는 커뮤니티 스킬, 즉 공개 저장소의 SKILL.md 파일을 실행할 수 있는 에이전트로 바꿀 수 있습니다. 실행할 때마다 스킬을 가져오지는 않습니다. 문서는 가져오기를 "an explicit, auditable pipeline with human review"(사람의 검토가 있는, 명시적이고 감사 가능한 파이프라인)라고 설명합니다. 파일은 한 번 내려받아 검증 에이전트가 확인하고, 매니페스트로 바뀐 뒤 여러분의 승인을 기다리며, 그다음에야 등록됩니다. 이 가이드는 명령부터 새 에이전트까지 이 파이프라인을 따라갑니다.

1단계. 노드에 워크플로가 있는지 확인하기

skill-import는 내장 템플릿 중 하나입니다. Configuration Reference는 이것을 deploy_builtins 아래에, 이것이 의존하는 skill-validator 에이전트와 함께 나열합니다.

# 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

기본값은 false이므로, 새 노드에서는 워크플로를 찾기 전에 aegis-config.yaml에서 true로 바꾸세요. 그러면 aegis workflow list가 등록된 것을 보여 줍니다.

2단계. 시작 전에 여섯 상태 알아 두기

문서는 파이프라인을 한 줄로 보여 줍니다.

FETCH → PARSE_AND_VALIDATE → COMPOSE_MANIFEST → REVIEW → REGISTER → COMPLETE

FETCH는 파일을 내려받고, PARSE_AND_VALIDATE와 COMPOSE_MANIFEST는 Agent 상태입니다. REVIEW는 Human 상태로 "Approval gate before registration"(등록 전 승인 게이트)이며, REGISTER는 "Deploys the composed agent manifest"(조합된 에이전트 매니페스트를 배포합니다). REVIEW 전에는 아무것도 등록되지 않습니다.

3단계. 스킬 파일과 이름 정하기

필수 입력은 skill_url 하나이며, "URL to a raw SKILL.md file (GitHub raw URL, registry URL, or any HTTP endpoint)"(원본 SKILL.md 파일의 URL: GitHub raw URL, 레지스트리 URL 또는 어떤 HTTP 엔드포인트든)입니다. 파일을 보여 주는 저장소 페이지가 아니라 원본 파일을 가리키세요. 스킬이 선언한 이름 대신 직접 정한 이름을 쓰고 싶다면 agent_name_override를 더하세요.

4단계. 보안 프리셋 고르기

세 번째 입력 security_preset은 생성되는 에이전트의 보안 정책을 정합니다. 문서는 두 값을 나열합니다.

minimal(기본값): 네트워크 전부 차단, 파일 시스템 읽기 전용, 자원은 CPU 500m, 메모리 256Mi, 타임아웃 5m.
permissive: 스킬의 도구가 선언한 호스트로만 네트워크 허용, /data 읽기 접근, CPU 1000m, 메모리 512Mi, 타임아웃 10m.

minimal로 시작하고, permissive는 도구를 직접 읽어 본 스킬에만 주세요.

5단계. 가져오기 실행하기

이름을 직접 지정하는 문서의 예시입니다.

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

permissive 프리셋을 쓰는 예시입니다.

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

CLI Reference에는 워크플로의 로그를 스트리밍하는 --follow와 완료될 때까지 기다리는 --wait도 있습니다. 실행이 출력하는 실행 ID를 보관하세요. 검토 게이트에서 필요합니다.

6단계. 검증기가 확인한 것 읽기

사람의 게이트에 앞서 skill-validator 에이전트가 스킬을 검사합니다. 문서가 밝히는 검사 대상은 프롬프트 인젝션과 탈옥 시도, 보안 통제를 우회하라는 지시, 데이터 유출 패턴, 내부 시스템 경로 참조입니다. 또한 지시의 품질과 일관성을 평가하며, 이 점수는 "must score above 0.7"(0.7을 넘어야 합니다). 통과하지 못한 스킬은 "is rejected before reaching the human review stage"(사람의 검토 단계에 이르기 전에 거부됩니다). 그러니 REVIEW에 끝내 도달하지 않는 실행은 이 상태에서 멈춘 것입니다. 실행 ID와 함께 aegis workflow executions get을 쓰면 실행의 현재 상태와 Blackboard를 볼 수 있습니다.

7단계. 조합된 매니페스트 검토하기

REVIEW에서 워크플로는 여러분을 기다립니다. 문서는 조합된 매니페스트, 곧 여러분이 승인하는 내용에 무엇이 들어 있는지 밝힙니다.

SKILL.md 프런트매터의 메타데이터(이름, 설명, 레이블)
"for traceability"(추적 가능성을 위한) 레이블 source: skill-import와 skill-origin: community
스킬의 지시 본문 전체로 채운 작업 지시
스킬의 allowed-tools 필드에서 AEGIS MCP 도구 형식으로 옮긴 도구
고른 프리셋의 보안 정책
한 번만 시도하는 실행 전략: mode: one-shot, max_retries: 1

도구 목록을 프리셋과 대조해 읽으세요. 검증기는 지시를 평가할 뿐이고, 이 스킬이 이 도구들을 가져도 되는지는 여러분의 검토가 결정합니다.

8단계. 승인하거나 거부하기

에이전트를 등록하려면:

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

멈추려면:

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

Workflow Manifest Reference는 input_equals_yes 조건이 받는 값에 "approve"를, input_equals_no가 받는 값에 "reject"를 넣어 둡니다. 승인되면 REGISTER가 매니페스트를 배포하고 COMPLETE가 이를 확정합니다.

9단계. 나중에 에이전트 찾기

가져온 에이전트에는 모두 source: skill-import와 skill-origin: community가 붙으므로, 지금의 목록에서든 나중의 감사에서든 이 레이블로 커뮤니티에서 온 에이전트와 여러분의 팀이 작성한 에이전트를 구분합니다. aegis agent list는 노드의 에이전트를 나열합니다.

문서가 답하지 않는 것

게이트 단어. 이 페이지는 "approve"와 "reject"로 신호를 보냅니다. Workflow Manifest Reference는 둘 다 받고, Human Approvals 페이지는 yes, y, 1을 나열합니다. REVIEW 상태가 어느 목록을 쓰는지는 가져오기 페이지에 없습니다.
거부할 때의 피드백. 페이지는 "Or reject with feedback"(또는 피드백과 함께 거부)이라고 하지만 명령은 "reject"만 보냅니다. 피드백을 붙이는 방법은 나오지 않습니다.
검토 타임아웃. REVIEW가 얼마나 기다리는지, 아무도 답하지 않으면 어떻게 되는지 페이지는 말하지 않습니다.
조합된 매니페스트를 읽는 곳. 매니페스트의 내용은 나열하지만, 신호를 보내기 전에 검토자에게 그것을 보여 주는 명령은 없습니다.
레이블로 거르기. CLI Reference는 aegis workflow list에는 --label을 보여 주지만 aegis agent list에는 보여 주지 않습니다.
다시 가져오기. 같은 스킬을 두 번 가져오거나 원본 파일이 나중에 바뀌면 어떻게 되는지 어디에도 없습니다.

REVIEW 상태는 평범한 Human 상태이므로, 여러분이 쓰는 어떤 워크플로에도 같은 게이트를 넣을 수 있습니다. 가이드 오케스트레이터에 승인 단계를 주는 방법이 그 예를 하나 따라갑니다. AEGIS는 100monkeys.ai에 적힌 명령으로 설치합니다.

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

100monkeys.ai에서 AEGIS 설치하기