skills

이 저장소는 Jon Hill의 공개 이식 가능한 에이전트 스킬(Agent Skills) 모음입니다. 각 스킬은 자체 완결적이며 모델과 하네스에 구애받지 않는 지침으로, AI 코딩 에이전트가 필요할 때 로드할 수 있습니다. 각 스킬은 개별적으로 설치 가능하며, 특정 하네스에 종속되거나 비공개 도구에 의존하는 부분이 없습니다. ## 설치 `npx skills add jonhill90/skills --list`로 모음을 둘러보거나, `npx skills add jonhill90/skills --skill tmux --skill github-cli`로 현재 프로젝트에 특정 스킬을 설치할 수 있습니다. `npx skills` CLI는 재현성을 위해 `skills-lock.json`에 콘텐츠 해시로 설치를 고정합니다. 이 저장소는 또한 Agent Plugins 1.0.0 플러그인(루트에 `plugin.json`, 스킬은 `skills/<name>/SKILL.md`에 위치)으로 동작하며, `.claude-plugin/`을 통해 Claude Code 플러그인으로도 동작합니다. `claude plugin marketplace add jonhill90/skills`로 마켓플레이스를 추가하고 `claude plugin install jonhill90-skills@jonhill90`으로 설치하면 됩니다. 이 플러그인은 고정된 버전이 없어 `main`의 최신 커밋을 추적하며 전체 모음(세션당 약 5.6k 토큰의 스킬 설명)을 로드합니다. ## 이 모음의 스킬 이 모음에는 42개의 스킬이 있으며, 각각 로컬 머신이나 CLI 가정이 감지되었는지를 나타내는 업로드 감사 상태(PASS 또는 FAIL)가 있습니다. 예시는 다음과 같습니다: - `ask-a-council` — 여러 관점에 자문 - `devils-advocate` — 가정에 도전 - `failing-test-first` — 테스트 주도 개발 - `github-cli` — GitHub CLI 사용 - `obsidian` — Obsidian 노트 관리 - `prd` — 제품 요구사항 문서 - `spec-driven-development` — 명세 우선 개발 - `tdd` — 테스트 주도 개발 - `tmux` — tmux 터미널 멀티플렉서 - 그리고 계획, 리서치, 메모리, 안전한 삭제 같은 워크플로를 다루는 다수의 스킬. ## 스킬이 속할 위치 README는 대부분의 스킬이 이 저장소에 있어서는 안 된다고 조언합니다. 배치는 사용 방식에 따라 달라집니다. 서로 무관한 여러 프로젝트에서 유용한 스킬은 이와 같은 공개 모음에 속하고, 하나의 저장소에서만 참인 스킬은 그 저장소의 `.claude/skills/` 또는 `.agents/skills/`에 속하며, 일회성 또는 외부에서 유지 관리되는 스킬은 `npx skills use <package>@<skill>`로 직접 사용할 수 있습니다. ## 작성 규약 각 스킬은 `skills/<name>/SKILL.md`에 위치하며 선택적으로 `scripts/`, `references/`, `assets/` 디렉터리를 가질 수 있습니다. 이식 가능한 프런트매터에는 `name`과 `description`(그리고 선택적으로 `license`, `compatibility`, `metadata`, `allowed-tools`)이 포함됩니다. 디렉터리 이름은 `name`과 일치해야 하며, `SKILL.md`는 500줄 미만으로 유지하고 세부 내용은 연결된 참조로 옮겨야 합니다. 전체 규약은 `AGENTS.md`에 있습니다. ## 검증 저장소를 검증하려면 `python3 scripts/validate_repository.py`와 `python3 -m unittest discover -s tests -v`를 실행하세요. CI는 모든 풀 리퀘스트와 `main`으로의 푸시에서 두 가지를 모두 실행합니다. ## 콘텐츠 경계 이 저장소에는 이식 가능한 스킬 콘텐츠와 최소한의 검증/테스트/CI만 포함됩니다. 개인 하네스 구성(정규 지침, 훅, 에이전트, 설정, MCP 선언, 설치/동기화 도구)은 별도의 개인 하네스 저장소에 있습니다. 현재로서는 여기에 동작 평가 시스템이 없으며, 커뮤니티가 유지 관리하는 대체 시스템이 이슈 #309에서 추적되고 있습니다. 고용주 소유 또는 프로젝트 특정 자료는 여기에 절대 복사되지 않습니다.