🧠 AI 코딩 표준 및 에이전트 스킬
엔지니어링 원칙을 배우고, 맥락에 맞게 적용하며, 결과를 검증하세요.
AI 코딩 에이전트와 개발자를 위한 재사용 가능하고, 프로젝트 인식형 스킬의 공개 모음입니다.
이 스킬들은 AI가 기존 프로젝트 규칙을 이해하고, 더 나은 엔지니어링 결정을 내리며, 적절한 코딩 관행을 적용하고, 불필요한 복잡성을 초래하지 않고 변경 사항을 검증하도록 돕습니다.
📑 스킬 카탈로그
🛡️ 거버넌스 및 규율
| 스킬 | 설명 | 가장 적합한 경우 |
|---|---|---|
cite-or-stop | 증거 기반 주장을 강제하고, 반복적인 실패 시도를 방지하며, 막혔을 때 구조화된 핸드오프를 제공합니다. | 환각(hallucination), 근거 없는 가정, 재시도 루프 방지. |
🔄 메타 학습 및 자가 치유
| 스킬 | 설명 | 가장 적합한 경우 |
|---|---|---|
lesson-to-skill | 확인된 오류, 사용자 수정 사항, 반복적인 문제를 재사용 가능한 지침으로 변환하여 향후 작업에서 동일한 실수를 방지하도록 돕습니다. | 지속적 학습, 오류 방지, AI 에이전트 행동 개선. |
🏗️ 코딩 표준 및 모범 사례
| 스킬 | 설명 | 가장 적합한 경우 |
|---|---|---|
solid-principles | 개발자가 SOLID 원칙을 학습하고 적용할 수 있도록 돕습니다. 기존 코드를 분석하고 불필요한 추상화를 도입하지 않으면서 설계 개선을 제안합니다. | 깔끔하고 유지 관리가 용이하며 확장 가능한 코드. |
precision-and-rounding | 변경 사항을 제안하기 전에 기존 숫자 유형, 반올림 규칙, 계산 및 구성을 분석합니다. 명시적으로 지시하지 않는 한 기존 프로젝트 동작을 유지합니다. | 정밀도 손실, 잘못된 반올림, 계산 불일치 방지. |
database-query-patterns | 개선 사항을 권장하기 전에 데이터베이스 쿼리, ORM 패턴, 스키마 및 인덱스를 분석합니다. 기존 데이터 동작을 유지하면서 비효율적인 쿼리를 식별하는 데 도움을 줍니다. | 쿼리 최적화, 데이터베이스 성능, 데이터 정확성. |
학습 → 적용 → 검증: 원칙을 이해하고, 기존 프로젝트 규칙에 따라 적용하며, 결과를 검증하세요.
🚀 빠른 설정 및 사용법
⚡ 빠른 설치 (권장)
GitHub에서 직접 AI 코딩 스킬을 설치하세요:
npx skills add geek-prateek/ai-coding-standards
특정 스킬 설치:
npx skills add geek-prateek/ai-coding-standards --skill precision-and-rounding
프로젝트 전체에 글로벌 설치:
npx skills add geek-prateek/ai-coding-standards -g
사용 가능한 스킬 검색:
npx skills add geek-prateek/ai-coding-standards --list
skills.sh에서 스킬을 살펴보세요.
옵션 1: 글로벌 설정 (모든 프로젝트에서 작동)
한 번 설치하면 여러 프로젝트에서 이 스킬을 사용할 수 있습니다.
Google Antigravity
# Windows (PowerShell)
cd $HOME\.gemini\config\skills
git clone https://github.com/geek-prateek/ai-coding-standards.git .
# macOS / Linux
cd ~/.gemini/config/skills
git clone https://github.com/geek-prateek/ai-coding-standards.git .
Claude Code
cd ~/.claude/skills
git clone https://github.com/geek-prateek/ai-coding-standards.git .
참고: 스킬 검색 경로는 에이전트 및 버전에 따라 다를 수 있습니다. 지원되는 에이전트의 경우 Skills CLI가 권장되는 설치 방법입니다.
옵션 2: 프로젝트별 설정
특정 프로젝트에서 스킬을 사용하려면 필요한 스킬 폴더를 에이전트가 지원하는 스킬 디렉토리에 복사하세요.
예시:
my-project/
├── .agents/
│ └── skills/
│ ├── cite-or-stop/
│ │ └── SKILL.md
│ ├── lesson-to-skill/
│ │ └── SKILL.md
│ ├── solid-principles/
│ │ └── SKILL.md
│ ├── precision-and-rounding/
│ │ └── SKILL.md
│ └── database-query-patterns/
│ └── SKILL.md
└── src/
또는 Git 서브모듈 사용
git submodule add https://github.com/geek-prateek/ai-coding-standards.git .agents/skills/shared
코딩 에이전트가 중첩된 스킬 폴더를 검색할 수 있는지 확인하세요.
📂 저장소 구조
ai-coding-standards/
├── README.md
├── cite-or-stop/
│ └── SKILL.md
├── lesson-to-skill/
│ └── SKILL.md
├── solid-principles/
│ └── SKILL.md
├── precision-and-rounding/
│ └── SKILL.md
└── database-query-patterns/
└── SKILL.md
각 스킬에는 추가로 관련 참고 자료, 예제, 평가 사례가 포함될 수 있습니다.
➕ 새로운 스킬 추가 방법
저장소를 깔끔하고 확장 가능하게 유지하려면 다음을 따르세요:
- 디렉토리 생성:
<skill-name>/ SKILL.md추가: 유효한 YAML 프론트매터를 포함하세요.- 사용 시기 정의: 특정 문제와 활성화 기준을 설명하세요.
- 기존 프로젝트 규칙 준수: 정당한 이유 없이 패턴을 강제하거나 기존 동작을 변경하지 마세요.
- 일반적으로 유지: 독점 코드, 자격 증명, 내부 URL, 회사별 정보를 포함하지 마세요.
- 유용한 경우 평가 추가: 스킬 효과를 검증할 수 있는 실용적인 시나리오를 포함하세요.
- 카탈로그 업데이트: 새로운 스킬을 스킬 카탈로그에 추가하세요.
SKILL.md 예시:
---
name: skill-name
description: >-
스킬이 수행하는 작업과 사용 시기를 설명합니다.
---
스킬 제목
학습
실용적인 예제를 통해 개념을 설명합니다.
적용
변경 사항을 제안하기 전에 기존 프로젝트 규칙을 분석합니다.
검증
정확성, 호환성, 엣지 케이스를 검증합니다.
중요: 프로그래밍 개념이 존재한다고 해서 바로 스킬을 만들지 마세요. 반복적인 문제가 특정하고 재사용 가능한 워크플로의 이점을 얻을 때 만드세요.
🤝 기여
기여, 제안, 개선은 언제나 환영합니다!
기존 스킬을 개선하거나 새 스킬을 제안하려면 자유롭게 이슈를 열거나 풀 리퀘스트를 제출하세요.
📄 라이선스
라이선스 정보는 저장소의 LICENSE 파일을 참조하세요.