skills
무엇인가
이 저장소는 에이전트가 기능 하나를 처리하는 전 과정을 정해진 순서와 산출물로 통과시키는 스킬 묶음이다. 병렬 작업 충돌, 워크플로마다 복제되는 운영 로직, 검증 없는 완료 주장, 해결되지 않은 리뷰 코멘트, 기계가 쓴 듯한 문체를 각각 별도 스킬이 규율한다.
어떻게 동작하나
각 스킬은 폴더 하나에 SKILL.md를 두고, frontmatter의 name·description과 본문 지시문으로 구성된다. Claude는 작업이 스킬 설명과 맞을 때 해당 파일을 온디맨드로 로드한다. before-and-after는 @vercel/before-and-after CLI를 구동해 `| Before | After |` 비교 표를 만들고, evidence-driven-testing은 scripts/evidence.py의 doctor·start·annotate·stop 명령으로 세션을 녹화해 evidence.mp4와 report.md·manifest.json을 생성하며, greploop은 --max-iterations(기본 10)까지 리뷰 트리거·수정·스레드 해결·푸시를 반복한다.
무엇과 다른가
프롬프트를 매번 직접 쓰거나 단일 CLAUDE.md에 규칙을 몰아넣는 방식과 달리, 스킬별로 분리되어 작업 매칭 시에만 로드되고 각 스킬이 실행 가능한 절차(CLI 호출, 스크립트, 체크리스트)를 포함한다. AGENTS.md는 이 스킬들을 isolate → build → prove → ship의 네 박자로 엮는 상위 템플릿이며, unslop은 그 과정에서 사람이 읽을 모든 텍스트에 적용된다.
어떻게 쓰나
스킬 폴더를 그대로 가져다 쓰고 AGENTS.md를 프로젝트에 놓으면 워크플로가 묶인다. 첫 작업은 new-feature로 origin/main에서 분기한 격리 워크트리에서 시작하고, before-and-after를 쓰려면 npm i -g @vercel/before-and-after agent-browser로 CLI를 먼저 설치한다. greploop-apps는 일반 greploop 트리거가 파일 수 초과로 거부될 때 @greptile-apps 태그로 우회하고, 체크 런이 없으면 Greptile의 수정된 요약 코멘트를 폴링한다.
전제와 한계
기준 대상은 Claude Code이며 Cursor용 하네스 델타가 포함된다. evidence recorder는 libx264와 ass 필터를 포함한 ffmpeg/ffprobe와 화면 캡처 소스가 필요하다 — Linux는 X11 또는 wlroots Wayland(GNOME/KDE 미지원), macOS는 화면 기록 권한, Windows는 표준 ffmpeg. 헤드리스 환경은 스크립트 스크린샷과 Playwright 캡처로 대체하고, 증거 게시에는 gh CLI가 필요하다. greploop 계열은 저장소에 Greptile이 설치되어 있고 gh/glab/p4가 인증되어 있어야 동작한다.
유사 스킬
- ok-skills문서 조회·브라우저 자동화·파일 기반 계획 수립 절차를 SKILL.md로 묶어 Claude Code와 Codex에 주입하는 스킬 모음이다.
- agent-rules-books리팩터링·클린 아키텍처·DDD·DDIA 같은 고전 공학서의 설계 규칙을 SKILL.md로 주입해 에이전트의 추상화·의존성·일관성 판단을 규율하는 스킬 묶음이다.
- agent-skillsVercel 비용·성능 감사, React/Next.js 최적화, UI 접근성, 문서 문체 규칙을 SKILL.md 묶음으로 주입해 에이전트가 코드와 글을 검토하게 하는 스킬 팩이다.
- cc-skills-golangGo 코드 스타일·네이밍·에러 처리·동시성·테스트·관측성 규칙을 SKILL.md 묶음으로 주입해 에이전트가 프로덕션 수준 Go 관례를 따르게 한다.
- copilot-instructionsCopilot에 DDD·클린 아키텍처·CQRS·테스트 규칙과 TDD 우선 워크플로를 주입하는 프롬프트 팩이다. instructions·skills·agents·plugins로 배포한다.