vibeship-spawner-skills
무엇인가
Spawner Skills는 코딩 에이전트에 제품 출시와 기술 스택별 전문 지식을 주입하는 스킬 묶음이다. 단일 규칙 문서가 아니라 스킬마다 정체성, 함정, 검증, 협업 규약을 분리한 지식 시스템을 설치한다. 규율하는 영역은 구현 패턴 선택, 안티패턴 회피, 배포 전 품질 검사, 스킬 간 위임 순서다.
어떻게 동작하나
스킬 하나는 4개 파일로 구성된다. skill.yaml은 역할·성격(identity), 권장 패턴(patterns), 금지 패턴(anti_patterns), 다른 스킬로 넘기는 조건(handoffs)을 정의한다. sharp-edges.yaml은 severity·situation·symptoms·detection_pattern 필드로 함정을 기술하고, validations.yaml은 conceptual 또는 regex 타입의 검사 항목과 file_patterns·fix_action을 선언한다. collaboration.yaml은 receives_from, delegation_triggers, common_combinations로 스킬 간 연결을 규정한다. 설치는 ~/.spawner/skills/ 아래에 이루어지며, 에이전트가 해당 경로의 YAML을 직접 읽거나 MCP 서버 도구를 통해 프로젝트 메모리·코드 검증·함정 탐지를 호출하는 방식으로 발동한다.
무엇과 다른가
일반적인 md 프롬프트 파일과 달리 서술과 검사 항목이 분리되어 있다. 함정은 문장이 아니라 detection_pattern 정규식과 symptoms 목록으로 표현되고, 검증은 조언이 아니라 severity와 fix_action을 가진 실행 단위로 선언된다. 스킬 간 위임도 자연어 지시가 아니라 trigger 패턴과 sequential·parallel 같은 실행 형태로 명시된다. 결과적으로 에이전트가 읽을 지식과 적용할 검사가 같은 파일 안에서 구분된다.
어떻게 쓰나
설치는 npx github:vibeforge1111/vibeship-spawner-skills install --mcp 한 줄로 끝난다. 이 명령이 스킬을 ~/.spawner/skills/에 설치하고 Claude Desktop과 Claude Code에 Spawner MCP 서버를 설정한다. MCP 없이 스킬만 설치하려면 --mcp를 빼고, 기존 설치에 MCP를 추가하려면 setup-mcp를, 갱신은 update를, 상태 확인은 status를 쓴다. 첫 사용은 에이전트에 Read: ~/.spawner/skills/maker/micro-saas-launcher/skill.yaml 형태로 파일 경로를 지정해 읽히는 것이다.
전제와 한계
README 기준 대상은 Claude Desktop과 Claude Code이며, 스킬 파일은 오프라인에서 동작하고 API 비용이 들지 않는다. MCP 도구는 --mcp 옵션으로 설치한 경우에만 노출된다. validations.yaml의 검사는 에이전트가 읽고 따르는 선언이며 별도 런타임이 강제 실행하는 것이 아니다. Codex·Cursor 등 다른 에이전트에 대한 지원은 README에 명시되어 있지 않다. 라이선스는 Apache 2.0이다.