스킬 빌: AI 코딩 스킬을 위한 마크다운 기반 거버넌스 프레임워크

Skill Bill이란 무엇인가

Skill Bill은 완전히 Markdown으로 구축된 AI 코딩 스킬을 위한 거버넌스 프레임워크입니다. 이는 개발자가 다양한 에이전트 간에 여러 AI 프롬프트를 관리할 때 직면하는 일반적인 문제들—명명법 변화, 중복 로직, 플랫폼별 코드가 일반 스킬에 스며드는 문제, 단일 진실 공급원의 부재—를 해결합니다.

시작 과정

개발자는 특정 작업을 위한 개별 스킬로 시작했습니다: Android/KMP 작업을 위한 코드 리뷰 프롬프트, 문제를 억제하는 대신 수정하는 규칙을 가진 gradle check 스킬, feature flag 스킬, 그리고 설계 문서에서 기능을 구현하는 스킬입니다. 에이전트들에 흩어진 약 12개의 스킬을 축적한 후, 일관되지 않은 명명법과 Kotlin 특정 로직이 일반 스킬로 간주되는 곳에 나타나는 "익숙한 부패"를 경험했습니다.

오케스트레이터의 돌파구

핵심 혁신은 다른 스킬들을 순차적으로 호출하는 feature-implement 스킬을 만드는 것이었습니다. 이 오케스트레이터는 설계 문서를 받아 계획을 수립하고, 기능 플래그 전략에 대해 묻고, 코드를 구현하며, 리뷰를 실행하고, 완성도를 확인합니다. 단일 feature-implement 실행은 10-12개의 스킬 호출을 연결합니다: 오케스트레이터, 스택 감지 코드 리뷰 라우터, 병렬로 실행되는 3-5개의 전문 리뷰어, 품질 검사, PR 설명, 그리고 선택적 기능 플래그 설정.

비용 고려사항

개발자는 Max 구독을 사용하는 Claude Code를 사용하며, 초기에는 사용 비용을 고려하지 않았습니다. 그러나 Codex Pro 구독을 사용하는 친구는 단일 code-review 스킬 호출(전체 체인이 아닌)이 5시간 Pro 요율 제한의 40-50%를 소모한다고 보고했습니다. Copilot은 다른 청구 모델(토큰 양당이 아닌 대화 턴당)을 사용하여, 이 접근 방식에 대해 더 비용 효율적입니다.

기술 아키텍처

이 프레임워크는 코드처럼 기능하는 구조화된 Markdown을 통해 여러 프로그래밍 언어를 지원하도록 발전했습니다:

• 상속: 플랫폼 오버라이드를 가진 기본 스킬
• 라우팅 로직: 스택 감지 및 적절한 전문가에게 위임
• 인터페이스 계약: 스킬 간 정의된 관계
• 검증: 저장소 부패를 방지하기 위한 명명 규칙과 구조 강제

기본 계층이 적절히 일반화되자, PHP 지원을 추가하는 것은 간단했고, 그 다음으로 Go가 추가되었습니다. 이 프레임워크는 현재 Kotlin, Android/KMP, Kotlin 백엔드, PHP, Go에 걸쳐 44개의 스킬을 포함합니다.

주요 기능

• 올바른 플랫폼 전문가에게 자동으로 라우팅하는 기본 스킬
• 명명 규칙과 구조를 강제하는 검증기
• Claude Code, Copilot, GLM, Codex와 동기화되는 단일 저장소
• feature-implement와 같은 모든 것을 처음부터 끝까지 연결하는 오케스트레이터 스킬
• 현재 Kotlin 계열과 Go/PHP 백엔드에 가장 강력하지만, 새로운 플랫폼으로 확장되도록 설계됨

실질적 의미

개발자는 프롬프트 저장소가 일반 소프트웨어와 동일한 엔지니어링 문제를 가지고 있음을 발견했습니다. 스킬을 계약, 검증, 구성 가능성을 가진 코드처럼 취급함으로써, 전체 시스템이 극적으로 더 유지보수 가능해졌습니다. 이 프레임워크는 MIT 라이선스 하에 GitHub에서 https://github.com/Sermilion/skill-bill 에서 이용 가능합니다.