dzhng/skills

Reusable AI agent skills for software factories: explore ideas, write specs, implement, review, and run autonomous research. Works with Claude Code, Codex, and other skill-compatible agents.

무엇인가요

Skills는 많은 AI 코딩 어시스턴트(Claude Code, Codex, Cursor, Duet 등)에 플러그인할 수 있는 재사용 가능하고 도메인 독립적인 에이전트 스킬의 개인 라이브러리입니다. 각 스킬은 워크플로우의 단일 조각(알 수 없는 요구 사항 탐색, 사양 작성, 자동화된 연구 실행, 코드 검토 또는 시각적 디자인 확인 등)을 설명하는 작고 독립적인 폴더입니다. 이 저장소는 정의, 문서 및 선택한 하네스의 스킬 디렉토리에 컬렉션을 설치할 수 있는 작은 CLI를 제공합니다.

왜 중요한가요

현대의 AI 기반 개발은 단일 작업 프롬프트에서 결과가 신뢰할 수 있을 때까지 목표를 반복하는 자율 에이전트인 소프트웨어 팩토리로 이동하고 있습니다. 이를 가능하게 하려면 에이전트가 호출, 검증 및 연결할 수 있는 잘 정의되고 구성 가능한 작업 세트가 필요합니다. 이 저장소는 바로 그것을 제공합니다. 대규모 기능을 독립적으로 검증 가능한 조각으로 나누고, 살아있는 사양을 유지하며, 에이전트가 내리는 모든 결정을 감사하는 엄선된 '빌딩 블록' 스킬 세트입니다. 이러한 스킬을 재사용하면 다음을 수행할 수 있습니다:

각 프로젝트에 필요한 사용자 지정 프롬프트의 양을 줄입니다.
각 단계(탐색, 사양 작성, 구현, 검토)가 반복 가능하고 감사 가능하도록 보장합니다.
동일한 라이브러리를 다양한 AI 코딩 환경에 플러그인합니다.

시작하기

컬렉션 설치 – npm 레지스트리를 통해:
```
npx skills add dzhng/skills
```
또는 로컬 클론에서:
```
npm run install-skills   # ~/.agents/skills에 설치하고 ~/.claude/skills에 링크합니다
```
npm run install-skills -- ../my-app을 사용하여 특정 저장소를 대상으로 지정할 수 있습니다.
스킬 선택 – npm run list-skills를 실행하여 카테고리(엔지니어링, 비주얼, 저작, 그래픽)와 이름을 확인합니다.
호출 – 대부분의 하네스는 슬래시 명령을 노출합니다(예: /explore-unknowns 또는 /implement-spec). 스킬은 대화형으로 질문하고, 아티팩트를 생성하며, specs/ 폴더 아래에 파일을 작성합니다.
연결 – 일반적인 엔드투엔드 흐름은 다음과 같습니다:
1. /explore-unknowns → 문제를 매핑합니다.
2. /write-spec → 맵을 검증 가능한 사양으로 변환합니다.
3. /goal /implement-spec specs/<feature> → 에이전트가 무인으로 기능을 구축하도록 합니다.
4. /review (또는 /audit-choices) → 결정 원장을 가져오고 루프를 닫습니다.

포함된 내용

카테고리	스킬 예시	기능
엔지니어링	`explore-unknowns`	인터뷰를 통해 알려진 것, 알려지지 않은 것, 가정 및 위험의 4분면 맵을 생성합니다.
	`write-spec`	기능을 명확한 API 경계가 있는 독립적이고 테스트 가능한 조각으로 나눕니다.
	`implement-spec`	목표 모드 하네스를 사용하여 에이전트가 각 조각을 구축하도록 유도합니다.
	`auto-research`	빠른 실험을 실행하고, 지표를 평가하며, 매개변수 효과 맵을 반환합니다.
	`code-review`, `audit-choices`	차이점과 AI가 내린 모든 결정의 근거를 감사합니다.
비주얼 검토	`compare-screenshots`	스크린샷을 기준선과 비교하여 차이를 확인하고 시각적 회귀를 플래그 지정하는 스크립트를 생성합니다.
저작	`write-skills`	새로운 스킬 정의를 만들거나 편집하도록 돕습니다.
그래픽	`renderer`	WebGPU/TypeGPU를 사용한 GPU 렌더링에 대한 아키텍처 가이드라인을 제공합니다.

대상 사용자

개발자: 프롬프트 기반 작업의 기성 카탈로그를 원하는 AI 보조 도구 구축자.
팀 리더: AI 에이전트가 작업을 계획, 구현 및 감사하는 방식을 표준화하려는 분.
연구원: 자율 코딩 루프를 실험하고 재현 가능한 스킬 정의가 필요한 분.

라이선스

MIT – 무료로 사용, 수정 및 재배포 가능.

위의 모든 정보는 저장소의 README에서 직접 가져온 것입니다.