GitHub 블로그, 에이전트 스킬 실전 가이드 공개 한 번 만들어 여러 에이전트에서 실행하는 방법

에이전트 스킬은 SKILL.md를 중심으로 버전 관리되는 디렉터리로, 반복 가능한 작업을 언제, 어떻게 수행할지 기술한다. 같은 지침을 여러 에이전트가 공유할 수 있지만, 도구, 인증 정보, 권한은 환경 측이 제공해야 한다. 예를 들어 데이터베이스 조회 방법은 적을 수 있어도, 그 데이터베이스에 접근할 권한은 주어지지 않는다. 이 글은 GitHub Universe 2026에서 Procore의 Shishir Tewari 씨와 진행한 세션을 바탕으로 한다.

Proof Agent는 AI가 생성한 변경 사항을 원래 요청과 대조해 검증하는 스킬이다. 자기 검증은 검증이 아니라는 생각에서, 독립된 검증 역할을 실행한다. GitHub Actions 워크플로는 원래 요청과 코드 변경만 검증 역할에 넘기고, 코딩 에이전트 자신의 평가는 넘기지 않는다. 검증 역할은 PASS, FAIL, PARTIAL을 반환하며, 변경된 파일 안의 증거를 제시해야 한다. 이 Action은 diff에 대한 정적 리뷰이며, 코드나 테스트는 실행하지 않는다. 데모에서는 block-on-fail: false로 설정해 지적 사항을 권고로 취급했지만, 기본값에서는 FAIL이 나면 체크가 실패하고, 필수 체크라면 머지가 차단된다.

Data Forge는 여러 스킬을 연계하는 예시다. 고객 지원 데스크 파이프라인에서는 forge-init이 소스 테이블과 명명 규칙을 조사해 해결된 매니페스트로 기록하고, 다른 스킬들이 이를 읽는다. forge-builder는 Issue에서 풀 리퀘스트까지의 과정을 조율하고, forge-dbx는 데이터 기반에 대한 질의를, forge-lint는 팀 표준의 적용을 맡는다. 워크플로는 7단계로 이루어지며, 각 단계마다 사람의 체크포인트가 있고, 스키마 변경 전에는 승인을 요청한다. 프로젝트 고유의 이름과 설정은 매니페스트에 두고, 스킬에는 내장하지 않는다. forge-dbx는 매니페스트에 따라 Databricks 또는 DuckDB 어댑터를 선택하지만, DuckDB CLI의 설치와 접근 권한 부여는 환경 측의 역할이다.

여러 클라이언트 지원에서는 skills/*/SKILL.md를 원본 데이터로 삼고, 패키지용 스크립트로 Claude Code용 .claude-plugin/plugin.json, Cursor용 .cursor-plugin/plugin.json, GitHub Copilot용 .github/agents/*.agent.md를 생성한다. CI를 위해서는 node scripts/package.mjs --check라는 체크 모드가 있다. 도입 후에는 클라이언트가 스킬을 인식하고, 참조 파일을 읽어들이며, 필요한 도구를 사용하고, 요구한 증거를 반환하는지 확인한다. 안정적인 인터페이스, 공유 상태, 감사 추적, 장시간 제어, 모델 외부에서의 권한 강제가 필요한 경우에는 스킬보다 애플리케이션이 적합하다고 한다.