Claude Code, OpenCode, Gemini CLI, Cursor, VS Code Copilot, Codex, Windsurf, Antigravity 및 기타 AI 어시스턴트(AI assistants)를 위한 커뮤니티 주도형 AI 에이전트 기술(skills)입니다.

기술(Skills)은 AI 어시스턴트가 특정 프레임워크(frameworks), 라이브러리(libraries) 및 패턴(patterns)과 함께 작업하는 방법을 가르치는 특화된 지침 세트(instruction sets)입니다. 이는 AI가 모범 사례(best practices)와 컨벤션(conventions)을 따라 코드를 작성할 수 있도록 온디맨드 컨텍스트(on-demand context)를 제공합니다.

큐레이션된 기술 (Curated Skills)

• @Gentleman-Programming이 직접 제작하고 실전에서 검증되었습니다. 이는 코드 아키텍처(code architecture)에 대한 저의 사고 방식인 Scope Rule, 파일 명명 규칙(file naming conventions), 시그널 우선 접근 방식(signals-first approach) 등을 반영합니다. 일부 기술(테스트 및 Python 등)은 Prowler 팀과 협력하여 개발되었습니다.

커뮤니티 기술 (Community Skills)

• 커뮤니티를 위해 커뮤니티가 만든 기술입니다. 이 기술들은 승인되기 전에 민주적인 투표 과정을 거칩니다.

이 기술들은 제가 수년간의 개발을 통해 직접 테스트하고 개선해 온 패턴(patterns)과 관행(practices)을 나타냅니다.

여기서 시작하세요! conventional commits를 사용하여 적절한 PR을 생성하려면 github-pr 기술을 사용하세요.

기술 (Skill)	설명 (Description)	트리거 (Trigger)
github-pr	conventional commits를 사용하여 품질 높은 PR 생성	PR을 생성하거나 기여할 때
skill-creator	새로운 기술 생성	새로운 AI 에이전트 기술을 생성할 때

기술 (Skill)	설명 (Description)	트리거 (Trigger)
angular/core	Standalone components, signals, inject, zoneless	Angular 컴포넌트를 생성할 때
...
기술 (Skill)	설명 (Description)	트리거 (Trigger)
---	---	---
ai-sdk-5	Vercel AI SDK 5 패턴	AI 채팅 기능을 구축할 때
django-drf	Django REST Framework 패턴	Django로 REST API를 구축할 때

기술 (Skill)	설명 (Description)	트리거 (Trigger)
playwright	Playwright E2E 테스트	E2E 테스트를 작성할 때
pytest	Python pytest 패턴	Python 테스트를 작성할 때

기술 (Skill)	설명 (Description)	트리거 (Trigger)
jira-task	Jira 태스크 생성	Jira 태스크를 생성할 때
jira-epic	Jira 에픽 생성	Jira 에픽을 생성할 때

커뮤니티에서 기여하고 우리의 투표 프로세스를 통해 승인된 스킬(Skills)입니다.

스킬 (Skill)	설명 (Description)	작성자 (Author)
electron	크로스 플랫폼 데스크톱 애플리케이션을 구축하기 위한 Electron 패턴.	@gentleman-programming
...

각 에이전트(Agent)는 특정 디렉토리에서 스킬을 읽어옵니다. 원하는 스킬을 해당 에이전트의 올바른 경로로 복사하세요:

에이전트 (Agent)	macOS / Linux	Windows
Claude Code	~/.claude/skills/	%USERPROFILE%\/.claude\skills\
OpenCode	~/.config/opencode/skills/	%USERPROFILE%\/.config\opencode\skills\
Gemini CLI	~/.gemini/skills/	%USERPROFILE%\/.gemini\skills\
Cursor	~/.cursor/skills/	%USERPROFILE%\/.cursor\skills\
VS Code Copilot	~/.copilot/skills/	%USERPROFILE%\/.copilot\skills\
Codex	~/.codex/skills/	%USERPROFILE%\/.codex\skills\
Windsurf	~/.codeium/windsurf/skills/	%USERPROFILE%\/.codeium\windsurf\skills\
Antigravity	~/.gemini/antigravity/skills/	%USERPROFILE%\/.gemini\antigravity\skills\

각 skills/ 디렉토리 내부에서, 모든 스킬은 SKILL.md 파일을 포함한 자체 폴더에 저장됩니다:

skills/
react-19/SKILL.md
typescript/SKILL.md
...

# 저장소 클론 (Clone the repository)
git clone https://github.com/Gentleman-Programming/Gentleman-Skills.git
# 큐레이션된 스킬을 에이전트의 스킬 디렉토리로 복사
...

에이전트용 스킬 디렉토리가 존재하지 않는 경우 생성하세요:

Claude Code 예시

mkdir -p ~/.claude/skills

Gemini CLI 예시

mkdir -p ~/.gemini/skills

원하는 스킬 폴더를 복사하세요:

cp -r curated/react-19 ~/.claude/skills/

에이전트의 설정 파일(예: Claude Code의 경우 CLAUDE.md)에서 해당 스킬을 참조하세요:

스킬 (Skills)

React로 작업할 때는 ~/.claude/skills/react-19/SKILL.md를 먼저 읽으세요.

각 스킬은 다음을 포함하는 SKILL.md 파일을 가지고 있습니다:

트리거 조건 (Trigger conditions)

• AI가 이 스킬을 로드해야 하는 시점

패턴 및 규칙 (Patterns and rules)

• 준수해야 할 구체적인 코딩 컨벤션 (Coding conventions)

코드 예시 (Code examples)

• 참조용 구현 사례

안티 패턴 (Anti-patterns)

• 피해야 할 사항

AI가 일치하는 컨텍스트(예: React 컴포넌트 편집)를 감지하면, 스킬 파일을 읽고 해당 패턴을 응답에 적용합니다.

커뮤니티의 기여를 환영합니다! 전체 프로세스는 CONTRIBUTING.md를 참조하세요.

프로 팁 (Pro tip): github-pr 스킬을 로드하여 우리의 컨벤션을 따르는 PR (Pull Request)을 생성하세요!

포크 (Fork)
이 저장소를 포크하세요.

생성 (Create)
스킬 템플릿에 따라 여러분의 스킬을 만드세요.

제출 (Submit)
community/ 폴더로 컨벤셔널 커밋 (Conventional commits)을 사용하여 Pull Request를 제출하세요.

커뮤니티 투표 (Community votes)
리액션 (Reactions)을 사용하여 7일 동안 진행됩니다.

승인 (Accepted)
부정적인 투표보다 긍정적인 투표가 많으면 승인됩니다.

• PR에 리액션으로 투표하세요.

• 투표 기간:
  7일 - 승인 기준:
  긍정 투표 > 부정 투표

• 메인테이너 (Maintainers)는 예외적인 기여에 대해 패스트트랙 (Fast-track)을 적용할 수 있습니다.

skill-name/
├── SKILL.md # 메인 스킬 파일 (필수)
├── examples/ # 코드 예시 (선택 사항)
...

공식 Vercel 스킬을 찾고 계신가요? vercel-labs/agent-skills를 확인해 보세요.

MIT License - 자세한 내용은 LICENSE를 참조하세요.

Gentleman Programming과 커뮤니티가 정성을 다해 만들었습니다.