agentic-awesome-skills
무엇인가
AAS Core는 로컬 카탈로그 검색, 에이전트 소유 선택, 매니페스트 검증, 계획, 진단을 한 제품 모델로 묶는 에이전트 우선 제어 평면이다. 프로젝트를 AAS 쪽으로 업로드하지 않고, Codex나 Claude가 저장소를 검사해 재사용 가능한 지침을 고르는 과정을 규율한다. 다루는 문제 영역은 스킬 발견, 선택 근거 보존, 스택 검증, 적용 전 미리보기다.
어떻게 동작하나
동작은 로컬 stdio MCP 서버를 통해 이뤄진다. search_skills, get_skill, list_skill_files, read_skill_file, compose_stack, inspect_stack, diff_stack, export_selection_evidence, inspect_selection_evidence 도구를 노출하며, compose_stack은 메모리에서 읽기 전용으로 선택을 검증한다. MCP 세션 지침은 에이전트가 아키텍처, 도메인 동작, 데이터와 통합, 테스트, 보안, UX, 배포, 유지보수까지 프로젝트 표면 전체를 평가하고, 적용 가능한 역량마다 후보를 비교해 중복 없는 스킬로 덮거나 카탈로그 공백을 보고하도록 요구한다. 클라이언트나 aas CLI가 aas-stack.json과 별도 aas-selection-evidence.json 사이드카를 artifact-dir에 저장하고, aas stack validate와 aas stack plan이 검증과 불변 계획 미리보기를 수행한다. 번들 파일은 불활성 텍스트로 검증·판독되며, SKILL.md 플레이북과 플러그인, 번들, 워크플로, 직접 설치기는 콘텐츠·큐레이션·배포·호환 계층으로 유지된다.
무엇과 다른가
프롬프트를 직접 쓰거나 단일 CLAUDE.md·AGENTS.md 규칙 파일을 두는 방식과 달리, 카탈로그 전체를 로컬에서 읽고 에이전트가 정확한 스킬 ID를 소유해 선택한다. Core는 순위·추천·제외·은닉을 하지 않고 구조와 정체성 유효성만 검증하며, 메타데이터는 자격 게이트가 아니라 정보로 취급한다. 결과물이 일회성 설치가 아니라 승인된 스택과 불변 계획으로 남아 검토·재사용이 가능하고, Workbench는 브라우저 메모리에서 스택·계획 JSON을 검토만 하며 파일시스템에 접근하거나 설치하지 않는다.
어떻게 쓰나
Claude Code에 플러그인으로 붙이고 로컬 MCP stdio 서버를 등록한 뒤, 에이전트가 프로젝트를 검사해 카탈로그를 검색·판독하고 스킬 ID를 선택하게 한다. 이어서 aas stack validate로 제안을 확인하고 aas stack plan으로 대상별 불변 계획을 미리보기하며, 필요하면 Workbench에서 스택·계획 JSON을 검토한다. 적용과 복구는 실험적이며 지원되는 미리보기 경로 밖에 있다.
전제와 한계
Claude Code, Codex CLI, Cursor, Copilot, Gemini CLI, Antigravity, Kiro, OpenCode, Autohand Code 등 주요 에이전트 워크플로를 대상으로 한다. 구조·정체성 유효성은 의미 적합성, 호환성, 설정 정확성, 운영 안전성, 적용 안전성을 인증하지 않으며, Core는 선택의 의미적 완전성을 인증하지 않고 카탈로그 공백 보고는 에이전트 선언에 의존한다. Google과 무관한 독립 커뮤니티 프로젝트다.
관련 논문 1
유사 도구
- mcp-useTypeScript로 MCP 서버와 ChatGPT·Claude용 뷰 앱을 정의하도록 Zod 스키마·도구 등록·React 뷰 바인딩·Inspector 검증 절차를 에이전트에 주입하는 Claude Code 플러그인이다.
- agnixCLAUDE.md·AGENTS.md·SKILL.md·훅·MCP 설정을 456개 규칙으로 검사해 잘못된 필드와 무시되는 지시를 잡아내고 자동 수정까지 하는 린터 플러그인이다.
- open-design에이전트가 DESIGN.md 디자인 시스템과 스킬·플러그인 규칙을 읽어 프로토타입·덱·이미지·영상 산출물을 실제 파일로 생성하도록 절차를 주입하는 Claude Code 플러그인이다.
- xclaude-pluginiOS 빌드·테스트·시뮬레이터 도구를 8개 MCP 서버로 쪼개 작업별로 필요한 것만 켜게 하고, 도구 출력을 구조화 JSON으로 압축해 컨텍스트를 아끼게 하는 Claude Code 플러그인이다.