sickn33/agentic-awesome-skills

AAS Core – Agentic Awesome Skills (AAS)

무엇인가요

• 대규모 언어 모델 에이전트(예: OpenAI Codex, Anthropic Claude)가 로컬 카탈로그 내 2,115개 이상의 재사용 가능한 "스킬" 플레이북을 검색하고, 프로젝트에 필요한 정확한 ID를 선택하며, 선택된 항목을 기록하는 기계가 읽을 수 있는 매니페스트(aas-stack.json)를 생성할 수 있는 라이브러리 및 CLI입니다.
• 핵심 구성 요소는 읽기 전용입니다: 선택된 스킬의 ID와 구조를 검증하지만, 순위 매기기, 추천, 실행은 하지 않습니다. 별도의 CLI를 통해 불변 계획을 미리 보기하고, 로컬 디렉터리에 스킬 디렉터리를 복사하는 직접 설치 프로그램을 드라이런할 수 있습니다.

왜 중요한가요

• 에이전트는 코드베이스에서 행동하기 위해 구체적인 지침(예: "브레인스토밍", "체계적 디버깅")이 필요합니다. AAS는 안정적이고 검사 가능한 진실의 근거를 제공하여 동일한 지침 세트를 나중에 검토, 버전 관리, 재현할 수 있게 합니다.
• 모든 카탈로그 파일은 일반 텍스트(SKILL.md)이므로, 코드를 실행하지 않고도 검사할 수 있어 워크플로우를 안전하고 오프라인 상태로 유지할 수 있습니다.

핵심 개념

개념	역할
카탈로그	각각이 재사용 가능한 지침 세트를 설명하는 SKILL.md 파일의 디렉터리입니다.
MCP (Model-Control-Plane)	LLM이 호출할 수 있는 명령어(예: search_skills, get_skill, compose_stack 등)를 노출하는 로컬, 읽기 전용 서비스입니다.
에이전트 소유의 구성	LLM(Codex 또는 Claude)이 사용할 스킬 ID를 결정합니다. AAS는 목록의 검증만 수행합니다.
aas-stack.json	타겟 프로젝트에 선택된 정확한 스킬 ID를 기록하는 JSON 매니페스트입니다.
선택 증거	선택된 각 스킬의 이유를 로깅하는 선택적 사이드카(aas-selection-evidence.json)입니다.
CLI	aas stack validate는 매니페스트를 검증하고, aas stack plan은 읽기 전용 계획을 생성하며, aas stack install-preview는 직접 설치 프로그램을 드라이런할 수 있습니다.
워크벤치	매니페스트와 계획을 로드하는 브라우저 전용 UI이며, 파일 시스템에 쓰지 않습니다.

일반적인 워크플로우의 흐름

1. 로컬 MCP 구성 (프리뷰 가이드에 시작 방법이 설명되어 있습니다).
2. LLM(Codex/Claude)에게 리포지토리 검사를 요청하고, MCP를 사용하여 관련 스킬을 카탈로그에서 검색하도록 합니다.
3. 모델이 스킬 ID 목록(예: brainstorming, systematic-debugging)을 반환합니다.
4. MCP가 compose_stack를 실행하여 ID가 존재하고 구조적 제한(최대 128개 스킬)을 준수하는지 검증합니다.
5. 클라이언트 또는 aas CLI가 aas-stack.json(및 선택적으로 증거 파일)을 기록합니다.
6. aas stack validate를 실행하여 매니페스트를 다시 확인하고, aas stack plan을 실행하여 타겟용 불변 계획을 확인합니다.
7. (선택 사항) 직접 설치 프로그램(npx agentic-awesome-skills … --dry-run)을 사용하여 선택된 스킬 디렉터리를 ~/.agents/skills에 복사하는 것을 미리 확인합니다.
8. 인간의 승인 후, --dry-run 없이 설치 명령어를 반복 실행하여 스킬을 실제 적용합니다.

설치 및 진입점

• npm 패키지: npm exec --yes --ignore-scripts --package=agentic-awesome-skills@<version> -- agentic-awesome-skills …
• npx 단축키: npx agentic-awesome-skills --skills <comma-list> --dry-run (미리 보기) 또는 --antigravity로 Antigravity 스타일 타겟을 지정합니다.
• GitHub CLI (프리뷰): gh skill preview … / gh skill install …로 단일 스킬을 처리합니다.
• 설치 프로그램은 리포지토리의 얕은 부분 클론을 수행하고, npm 패키지 메타데이터의 커밋 해시와 일치 여부를 검증한 후, 요청된 스킬 디렉터리만 복사합니다.

특화된 플러그인

• 리포지토리는 사전 번들된 플러그인 팩(예: Web App Builder, Security Engineer, DevOps & Cloud)을 제공하며, 특정 도메인에 맞는 관련 스킬을 그룹화합니다.
• 플러그인은 Claude-Code 및 Codex 호환 번들로 생성되며, 표준 Agent Plugins 1.0 매니페스트도 노출합니다.

안전성 및 제한 사항

• AAS는 스킬 코드를 실행하지 않습니다. 파일 복사만 수행합니다.
• 핵심은 의미적 적절성을 보증하지 않습니다—LLM의 선택이 환경에 부적절할 수 있습니다.
• 일부 스킬은 중요 또는 공격적으로 표시되며, 설치 프로그램은 위험 요약을 출력하고, 전체 카탈로그를 다운로드하려면 명시적 동의(--all)가 필요합니다.
• 적용/복구 기능은 실험적으로 표시되어 있으며, 지원되는 프리뷰에서는 비활성화되어 있습니다.

사용할 때

• LLM 기반 개발 파이프라인을 운영하고 있으며, 모델이 실행 가능한 재현 가능하고 감사 가능한 지침 목록이 필요할 때.
• 파일이 쓰기 전에 모델이 선택한 내용을 정확히 검토해야 할 때(규제 준수, 보안, 팀 리뷰 환경).
• 리모트 서비스에 의존하지 않고, 프로젝트나 팀원 간에 커스터마이즈된 스킬 세트를 공유하고 싶을 때.

사용하지 않는 것이 적절한 경우

• skills/ 폴더의 단순한 키워드 검색만 필요할 경우, AAS는 추가 검증과 매니페스트 처리를 추가하므로 필요하지 않을 수 있습니다.
• 스킬의 자동 실행이 필요한 프로젝트(예: CI/CD 러너)는 자체 러너를 구축해야 하며, AAS는 정적 지침만 제공합니다.

더 알아보기

• 사용자 가이드: docs/users/aas-core.md (신뢰 경계, MCP 설정, CLI 라이프사이클).
• 워크플로우 및 사례 연구: docs/users/workflows.md.
• 보안 및 감사: docs/users/security-and-antivirus.md.
• 플러그인 카탈로그: plugins/ 디렉터리 및 호스팅된 랜딩 페이지 https://sickn33.github.io/agentic-awesome-skills/plugins.

---

결론: AAS Core는 프리뷰 단계의 로컬에서 실행 가능한 툴킷으로, AI 에이전트가 큰 검사 가능한 재사용 가능한 지침 "스킬" 라이브러리에서 선택하고, 선택 내용을 재현 가능한 매니페스트에 기록할 수 있게 합니다. LLM 기반 자동화의 힘을 얻으면서도, 설치되는 내용에 대한 완전한 감사 가능성과 제어를 유지하고자 하는 팀을 위한 것입니다.