Awesome Agent Skills

Emojery

AI 코딩 에이전트를 위한 스킬들: 코드 리뷰, 테스트 작성, 디자인 문서화(design docs), 디버깅, 보안 감사(security audits), 리팩토링, 그리고 AI가 작성한 코드와 텍스트를 정리하는 방법. 각 스킬은 Agent Skills 형식의 SKILL.md 파일을 포함하는 폴더로 구성되어 있으며, 이는 공개된 컬렉션과 대규모 오픈 소스 실습에서 추출되어 실제 리포지토리에서 다듬어졌습니다.

Claude Code, Claude.ai, OpenAI Codex, Gemini CLI, Cursor, GitHub Copilot, opencode, Amp, Windsurf, Antigravity, Kilo Code, Qwen Code 및 표준을 지원하는 다른 모든 에이전트와 함께 작동합니다.

Contents

• Awesome Agent Skills
  • Contents
  • Quick start
  • Install as a plugin
  • Skills
    • Code review
    • Code quality and refactoring
    • Testing
    • Design and planning
    • Understanding a codebase
    • Debugging and reliability
    • Audits
    • Git and repository operations
    • Agent maintenance
    • Writing and text
    • Content marketing
  • Usage examples
  • Skill dependencies
  • Skill format
  • Contributing
  • Related
  • License

Quick start

git clone https://github.com/khasky/awesome-agent-skills.git
cd awesome-agent-skills
npx skills add ./skills -g -s "*" -a claude-code codex gemini-cli -y

CLI에서 [skills CLI](https://github.com/vercel-labs/skills)를 사용하면 모든 스킬이 Claude Code, Codex, Gemini CLI에 전역으로 설치됩니다. -a를 변경하여 에이전트를 선택할 수 있습니다 (-a "*"는 감지된 모든 에이전트에 설치). 클론 과정을 건너뛰려면 npx skills add khasky/awesome-agent-skills를 사용하면 GitHub에서 바로 설치됩니다.

클론한 경우 git pull로 업데이트하거나, CLI가 링크 대신 복사본을 가져온 경우(ls -l ~/.agents/skills 확인: 링크 대상이 없는 항목은 복사본임)에는 npx skills update -g를 사용합니다. 새로운 스킬을 인식하려면 skills add를 다시 실행하세요.

플러그인으로 설치하기

플러그인은 모든 스킬을 한 번에 설치하고 리포지토리와 함께 업데이트됩니다. 플러그인 또는 빠른 시작 중 하나만 선택하세요. 둘 다 선택하지 마세요.

스킬

코드 검토 (Code review)

코드 품질 및 리팩터링 (Code quality and refactoring)

테스트 (Testing)

디자인 및 계획 (Design and planning)

이해하기 (Understanding a codebase)

디버깅 및 신뢰성 (Debugging and reliability)

감사 (Audits)

모든 감사는 읽기 전용이며, 릴리스를 통제하는 SHIP / FIX / BLOCK 판결로 끝납니다.

Git 및 저장소 작업 (Git and repository operations)

에이전트 유지보수 (Agent maintenance)

작성 및 텍스트 (Writing and text)

스킬 (Skill)

콘텐츠 마케팅 (Content marketing)

사용 예시 (Usage examples)

스킬은 의도(intent)에 따라 트리거되므로 일반 요청으로도 작동합니다. 스킬 이름을 지정하면 선택이 결정적(deterministic)이 됩니다:

• main의 diff에 대해 awesome-code-review를 사용하세요."
• 이 오류에 대한 awesome-bug-fix: 먼저 재현하고, 어떤 수정보다 근본 원인을 파악해 주세요 — [로그 붙여넣기]."
• 우리가 오픈 소스로 공개하기 전에 awesome-leak-audit로 이 리포지토리를 감사(Audit)하세요."
• awesome-humanize-en: 이 초안에서 AI의 목소리(AI voice)를 제거해 주세요."

또한 체인 연결도 가능합니다: 구현 → awesome-code-cleanup → 병합 전에 awesome-code-review. 또는: awesome-content-campaign → 초안 검토 → awesome-content-publisher.

게시된 히스토리나 포스트를 라이브 계정으로 재작성하는 네 가지 스킬(awesome-git-history-reset, awesome-git-history-rebuild, awesome-git-author-rewrite, awesome-content-publisher)은 명시적으로 이름을 지정할 때만 실행되며, 단순히 일치하는 요청만으로는 절대 실행되지 않습니다.

스킬 의존성 (Skill dependencies)

일부 스킬은 자체 복사본을 유지하기보다 다른 스킬과 함께 배포되는 참조 파일(reference file)을 읽기 때문에, 하나의 어휘나 플랫폼 테이블이 하나의 출처를 가집니다. 플러그인과 Quick start는 모든 스킬을 설치하며, 아무것도 고장 나지 않습니다. 단일 스킬만 설치할 경우(npx skills add ... -s <name>) 이러한 링크가 끊어질 수 있으므로, 해당 행의 스킬들도 함께 설치하세요.

⚠️ [IMG:N] 형식 토큰은 이미지 placeholder 입니다. 번역하지 말고 원래 위치에 그대로 유지하세요.

Skill 형식

각 스킬은 Agent Skills specification을 따릅니다:

skills/<skill-name>/ 
├── SKILL.md          # 필수: YAML 프론트매터 (이름, 설명) + 지침
└── references/       # 선택 사항: 에이전트가 필요할 때 로드하는 상세 문서

스킬은 마크다운(Markdown)이며 그 외의 것은 없습니다. 스크립트, 템플릿 또는 피처(fixtures)도 없으므로 여기에 있는 아무것도 사용자의 기기에서 실행되지 않습니다. 프론트매터의 description이 에이전트에게 언제 활성화할지 알려주며, 본문은 활성화 시에만 로드되고, references/는 필요할 때만 로드됩니다.

보고서는 두 가지 어휘(vocabulary)를 공유합니다: 발견 사항은 Critical / High / Medium / Low / Informational으로 등급이 매겨지며, 릴리스 게이팅 감사(release-gating audits)는 SHIP / FIX / BLOCK으로 끝나고, 확인할 수 없었던 항목에 대해서는 NOT ASSESSED가 쌍을 이룹니다.

기여 (Contributing)

하나의 문지기(gate), 로컬과 CI에서 동일하게 작동합니다:

python3 scripts/lint.py          # 수동으로 게이트 실행
python3 scripts/test_lint.py     # 손상된 복사본에 대해 각 게이트가 실패함을 증명
python3 scripts/install-hooks.py # 클론할 때 한 번: 모든 커밋 전에 실행

각 스킬은 세 번의 단계를 거쳤습니다: 공개 컬렉션 및 문서화된 관행(커널 패치 규칙, OWASP, WCAG, PTES, NIST SP 800-115)에 대한 조사, 에이전트의 출력을 변경하는 것만 유지하는 증류(distillation), 그리고 실제 저장소에서의 사용 라운드들입니다. 스킬은 자체 포함적이고(self-contained), 이식성이 있으며(portable), 스택에 구애받지 않고(stack-agnostic) 작성되었으며, 주장을 증명하는 확인 절차로 마무리됩니다.

관련 (Related)

• Awesome AGENTS.md — 모든 에이전트가 가져오는 기본적이고 도구에 구애받지 않는 규칙 세트(ruleset). 이 규칙들은 일상적인 작업을 정렬 상태로 유지하며, 여기에 있는 스킬들(skills)은 사용자가 지정하는 작업을 처리합니다. 둘 다 설치하세요.
• Agent MCP Integrations — 에이전트를 브라우저, 클라우드, 데이터베이스, 인프라 및 도메인 API에 연결하는 MCP 서버들.
• Claude Code Token Optimization — 토큰 효율성 계층(layer).
• Claude Code Security Audit — 계층화된 보안 감사 워크플로우(workflow).

라이선스 (License)

MIT license 하에 공개되었습니다. awesome-humanize-en 스킬은 humanizer-ru의 자료를 활용했으며, 그 장소 규칙(venue rules)을 위해 editing-trace tests와 evidence ledger는 sepia에서 가져왔습니다. awesome-seo-audit는 Google 정책 세부 사항을 claude-seo와 교차 확인했으며, 여기에서 모든 추천에 대한 반증 가능성(falsifiability) 라인, 수정 순서 규칙(fix-ordering rule), 그리고 안전하지 않은 가져오기 대상(unsafe fetch targets) 거부 원칙을 채택했습니다. 또한 수집 메커니즘은 on-page-seo에서 가져왔습니다. 이 스킬의 두 축 판결(two-axis verdict)은 claude-seo-ai를 따르며, 증거 및 신뢰도 계약(evidence-and-confidence contract)은 Agentic-SEO-Skill을 따릅니다. awesome-agents-md-generator는 섹션 세트와 차이점만 포함된 중첩 파일(differences-only nested files)은 agentseed에서 가져왔고, 파일 형식은 agents.md에서 가져왔습니다. awesome-code-explainer는 신호 우선 방식(signals-first method), 입력 양식(input forms), 그리고 읽기 경로 및 개방형 질문 섹션(reading-path and open-questions sections)을 ExplainThisRepo에서 가져왔습니다.

awesome-code-docs는 의존성 그래프 방식(dependency-graph method)—심볼 해석(symbol resolution), 위상 순서(topological order), 바텀업 요약(bottom-up summaries)—을 AutoDocs에서 가져왔습니다.