기타 Skills：압축 커뮤니케이션, 인수인계, 교육, Skill 작성 및 안전 가드레일

개별적으로 다루지 않는 이유

Matt의 README는 skills를 세 가지 범주로 나눕니다:

• Engineering: 매일 실제 코드를 작성하는 데 사용
• Productivity: 일반적인 워크플로우 도구
• Misc: 그가 비축해 둔 작은 도구들

앞선 몇 개의 글에서는 메인 라인에 해당하는 engineering skill을 다루었습니다. 이 글에서는 나머지 productivity와 misc를 함께 다룰 것입니다. 왜냐하면 이들은 대부분 완전한 개발 프로세스가 아니라, 특정 시나리오에서 유용한 작은 스위치이기 때문입니다.

만약 5개만 설치한다면, 여전히 다음을 우선적으로 설치하는 것을 추천합니다:

• /grill-me
• /grill-with-docs
• /to-prd + /to-issues
• /tdd
• /improve-codebase-architecture

하지만 메인 라인을 이미 실행하고 있다면, 다음 도구들이 일상 경험을 더욱 원활하게 만들어 줄 것입니다.

Productivity Skills

caveman: 커뮤니케이션 극단적 압축

/caveman은 "적은 토큰 모드"입니다. 에이전트에게 인사, 채움 단어, 과도한 설명, 모호한 완충을 제거하고 기술 정보만 남기도록 요구합니다.

다음과 같은 경우에 적합합니다:

• 빈번한 반복 작업 중이며 긴 응답을 읽고 싶지 않을 때
• 디버깅 시 사실, 원인, 다음 단계만 필요할 때
• 긴 컨텍스트가 거의 찼고 출력을 압축해야 할 때
• AI가 미사여구를 줄이도록 강제하고 싶을 때

이는 AI를 무례하게 만드는 것이 아니라, 더 짧은 문법으로 완전한 기술적 정확성을 유지하도록 하는 것입니다. 이 모드는 종료를 말할 때까지 계속 유효합니다.

이를 장기적인 기본값보다는 임시 설정으로 간주할 것입니다. 고위험 작업, 보안 경고, 복잡한 다단계 지시의 경우 너무 짧으면 오해하기 쉽습니다.

handoff: 현재 대화를 다음 에이전트에게 인계

/handoff의 목표는 현재 대화를 인계 문서로 압축하여 현재 작업 공간을 오염시키지 않고 시스템 임시 디렉토리에 저장하는 것입니다.

다음 내용을 포함합니다:

• 현재 목표
• 결정된 사항
• 주요 경로 및 파일
• 남은 작업
• 다음에 호출할 skill 추천
• 민감 정보 비식별화

긴 작업 중단, 컨텍스트 부족, 또는 다른 에이전트에게 작업을 계속 맡기고 싶을 때 특히 유용합니다.

핵심은 PRD, 이슈, ADR, 커밋, diff에 이미 존재하는 내용을 복사하지 않고 경로 또는 URL만 참조하는 것입니다. 인계 문서의 가치는 프로젝트 문서를 다시 만드는 것이 아니라, 대화에 흩어진 상태를 보완하는 것입니다.

teach: 현재 디렉토리를 학습 작업 공간으로 만들기

/teach는 이 그룹에서 가장 무거운 도구입니다. 현재 디렉토리를 장기 학습 작업 공간으로 취급하며 다음을 유지합니다:

• MISSION.md: 이 주제를 배우는 이유
• RESOURCES.md: 고품질 리소스 목록
• learning-records/*.md: 학습 기록 (ADR과 유사)
• lessons/*.html: 각 세션별 인터랙티브 강의
• reference/*.html: 빠른 참조 자료
• NOTES.md: 교육 선호도 및 작업 노트

이것의 장점은 학습을 일회성 질문이 아닌 장기적인 시스템으로 본다는 것입니다. 특히 강조하는 점은:

• 미션 우선: 무엇을 배우는지보다 왜 배우는지가 더 중요합니다.
• 검색 연습: 회상 연습을 통해 장기 기억을 구축합니다.
• 간격/교차 학습: 단기적인 유창함에 속지 마십시오.
• 높은 신뢰도의 자료: 먼저 자료를 찾고, 모델의 기억에 의존하여 말하지 마십시오.

단순히 "X에 대해 설명해 줘"라고 묻는 경우에는 필요하지 않지만, 몇 주 동안 특정 주제를 배우고 싶다면 매우 적합합니다.

write-a-skill: 새 skill 작성을 위한 스캐폴딩

/write-a-skill은 Matt가 skill 구조 자체를 추상화한 것입니다.

이것은 skill이 최소한 다음을 포함해야 한다고 요구합니다:

skill-name/
├── SKILL.md
├── REFERENCE.md
├── EXAMPLES.md
└── scripts/

물론 뒤의 세 가지는 필수가 아니며, 내용이 너무 길거나, 예시가 가치 있거나, 작업이 스크립트화될 수 있을 때만 추가합니다.

가장 중요한 판단은 description이 에이전트가 skill을 로드할지 결정할 때 유일하게 먼저 보는 정보라는 것입니다. 따라서 description은 "문서 처리를 돕는다"와 같은 공허한 말로 작성해서는 안 되며, 다음을 명확히 설명해야 합니다:

• 어떤 기능을 제공하는가
• 언제 트리거되는가
• 트리거 단어 또는 컨텍스트는 무엇인가

이는 제가 skill을 작성하는 경험과 일치합니다. 많은 skill이 실패하는 이유는 본문이 잘못 작성되었기 때문이 아니라, description이 너무 광범위하게 작성되어 에이전트가 언제 로드해야 할지 알지 못하기 때문입니다.

Misc Skills

git-guardrails-claude-code: 위험한 git 명령 차단

이 skill은 Claude Code에 PreToolUse 훅을 추가하여 Bash 실행 전에 위험한 git 명령을 차단합니다.

기본적으로 다음을 차단합니다:

• git push
• git reset --hard
• git clean -f / git clean -fd
• git branch -D
• git checkout . / git restore .

그 가치는 매우 직접적입니다: 에이전트가 귀하의 승인 없이 푸시하거나, 하드 리셋하거나, 추적되지 않은 파일을 삭제하는 것을 방지합니다.

AI가 실제 저장소에서 작업하도록 자주 하는 경우, 이 skill은 설치할 가치가 있습니다. AI를 신뢰하지 않는 것이 아니라, 고위험 작업은 도구 계층에서 차단하고 프롬프트에만 의존하지 않는 것입니다.

setup-pre-commit: 프로젝트에 커밋 전 검사 추가

/setup-pre-commit은 다음을 설정합니다:

• Husky pre-commit hook
• lint-staged + Prettier
• typecheck
• test

먼저 패키지 관리자를 감지한 다음, 프로젝트에 이미 있는 스크립트에 따라 pre-commit에서 실행해야 할 것을 결정합니다. typecheck 또는 test가 없을 경우 강제로 생성하지 않고 생략하고 알려줍니다.

이 skill의 가치는 설정 자체에 있는 것이 아니라, Matt의 품질 관점에 있습니다: AI가 코드가 문제없다고 말하게 하는 것에만 의존하지 말고, 결정적인 검사를 통과하게 하십시오.

migrate-to-shoehorn: 테스트에서 as 줄이기

이것은 매우 Total TypeScript 스타일의 작은 도구입니다. 테스트에서 TypeScript as 타입 단언을 @total-typescript/shoehorn으로 마이그레이션합니다.

일반적인 대체:

이것은 프로덕션 코드가 아닌 테스트 코드에만 사용하도록 명확히 되어 있습니다.

이 skill은 매우 제한적이지만, Matt의 엔지니어링 취향과 잘 맞습니다: 타입 시스템을 위해 테스트에서 20개의 무의미한 필드를 만들지 않고, 맨 as를 사용하여 타입 안전성을 완전히 비활성화하지도 않습니다.

scaffold-exercises: 강의 저장소에 연습 디렉토리 생성

이 skill은 분명히 Matt가 강의를 만드는 작업 흐름에서 나온 것입니다. 규격에 따라 다음을 생성합니다:

exercises/
└── 05-memory-skill-building/
    └── 05.02-short-term-memory/
        ├── explainer/
        ├── problem/
        └── solution/

각 하위 디렉토리는 최소한 비어 있지 않은 readme.md를 포함하고, 필요한 경우 main.ts를 포함하며, pnpm ai-hero-cli internal lint를 통과해야 합니다.

대부분의 엔지니어링 프로젝트에는 유용하지 않지만, 강의, 부트캠프, 연습 저장소에는 매우 실용적입니다. 더 중요한 것은, 좋은 skill의 특징을 보여준다는 것입니다: 반복적이고 기계적이며 세부 사항을 놓치기 쉬운 형식 작업을 에이전트에게 맡기는 것입니다.

현재 메인 라인에 포함하지 않는 이유

상위 저장소에는 deprecated/, in-progress/, personal/ 디렉토리가 더 있습니다.

이들을 공식 사용 가이드에 포함하지 않는 것을 권장합니다:

나중에 작성해야 한다면, 안정적인 추천 사항에 혼합하는 대신 "Matt Pocock skills 저장소 고고학"과 같은 별도의 글을 작성할 수 있습니다.

이 작은 도구들의 공통점

이 skill들은 매우 산발적으로 보이지만, 그 뒤에는 동일한 원칙이 있습니다:

에이전트가 쉽게 벗어날 수 있는 것을 작고 명확한 작업 패턴으로 만듭니다.

• caveman은 커뮤니케이션의 벗어남을 방지합니다.
• handoff는 컨텍스트 손실을 방지합니다.
• teach는 학습이 일회성 질문으로 변하는 것을 방지합니다.
• write-a-skill은 skill 구조가 즉흥적으로 작성되는 것을 방지합니다.
• git-guardrails는 위험한 명령이 자율에 의존하는 것을 방지합니다.
• setup-pre-commit은 품질 검사가 AI의 자체 보고에 의존하는 것을 방지합니다.
• migrate-to-shoehorn은 테스트 타입 단언이 통제 불능이 되는 것을 방지합니다.
• scaffold-exercises는 강의 구조가 수동으로 누락되는 것을 방지합니다.

이것이 Matt의 이 repo에서 가장 배울 만한 점입니다: skill은 거대할 필요가 없습니다. 자주 발생하는 작은 편차가 20줄의 명령으로 안정적으로 수정될 수 있다면, skill로 작성할 가치가 있습니다.

참고 자료