guard-skills
무엇인가
guard-skills는 Skills CLI로 배포되는 Markdown 스킬 패키지다. 코드 생성 자체를 수행하지 않고, 에이전트가 산출물을 낸 뒤 그 결과를 다시 검사하는 두 번째 패스에 놓인다. 다루는 영역은 AI 생성 코드·테스트·문서의 품질 게이트다.
어떻게 동작하나
저장소는 skills/ 아래에 스킬별 폴더를 두는 구조다. 각 폴더에는 진입점 SKILL.md, 에이전트 메타데이터 agents/openai.yaml, references/ 하위 참조 문서가 들어간다. SKILL.md는 분량을 작게 유지해 로딩 비용을 낮추고, 프레임워크별 세부 규칙이나 LLM 애플리케이션용 참조는 해당 작업에서만 읽힌다. 실행 스크립트 없이 Markdown과 YAML만으로 구성된다.
무엇과 다른가
전체 개발 프로세스 프레임워크나 플랫폼 카탈로그가 아니다. WordPress/agent-skills 같은 저장소가 에이전트에게 생태계 전반의 구현 방법을 가르치는 반면, 이 패키지는 산출물이 저장소에 도달하기 전에 실행하는 리뷰 게이트만 다룬다. 스킬을 작성 중 제약으로 쓸 수도 있지만 기본 용도는 diff에 대한 사후 검토다.
어떻게 쓰나
설치는 npx skills add amElnagdy/guard-skills로 패키지 전체를 받거나 단일 가드를 지정해 받는다. --global 또는 --project로 설치 범위를 정하고 특정 에이전트용으로도 설치할 수 있다. 설치 후 에이전트가 작업을 마치면 커밋·머지 전에 해당 가드를 diff에 호출한다.
전제와 한계
스킬은 복사본으로 설치되므로 저장소에 새 버전이 올라와도 갱신 전에는 반영되지 않는다. npx skills add를 다시 실행하거나 Skills CLI로 새로 받아야 한다. 외부 소스 URL은 각 스킬의 references/sources.md에 모여 있고, 네트워크 호출·MCP 서버 의존·자격 증명은 포함하지 않는다. Claude Code, Codex, Cursor, OpenCode 등 Skills CLI를 지원하는 에이전트에서 동작하며 라이선스는 MIT다.
유사 스킬
- dryforge사용자 의도·명세·기존 코드·검증 증거의 권위를 분리해, 에이전트가 임의 해석으로 구현을 확정하지 못하게 규율하는 Claude Code 플러그인이다.
- fable-method에이전트가 문제를 분류하고 최소 수정으로 고친 뒤 관찰로 검증하도록 순서와 임계값을 적은 스킬 묶음이다. 판정 스킬은 보고서 대신 실행 결과를 본다.
- security-audit-skill6단계 보안 감사 절차를 에이전트에 주입해 정찰·후보 검증·독립 재검증을 거쳐 기계 판독 가능한 findings.json을 산출하게 강제하는 스킬이다.
- andrej-karpathy-skillsClaude Code에 적용하는 단일 CLAUDE.md 지침 파일이다. Karpathy가 지적한 LLM 코딩 실수를 네 가지 원칙으로 막는다.