DarkGarden

Topics

Sections

코팩의 두번째 선물. 스킬을 검증하고, 스킬을 만들고, 스킬을 실행하는 스킬 무료 배포

22 min read

스킬로 스킬을 관리하는 메타 자동화 시스템

📺 원본 영상: 코팩의 두번째 선물. 스킬을 검증하고, 스킬을 만들고, 스킬을 실행하는 스킬 무료 배포
🎙️ 채널: 코드팩토리
📅 정리 일자: 2026-02-13
⚠️ Note: 본 리포트는 영상의 음성을 텍스트로 변환(STT)하여 정리한 것입니다. 화면에 표시된 자료(차트, 코드, 슬라이드 등)는 포함되지 않을 수 있습니다.

개요

이번 강연에서는 Claude Code의 스킬(Skill) 시스템을 활용하여 프로젝트 전반의 품질을 자동으로 관리하는 메타 자동화 구조를 소개한다. 단순히 스킬을 사용하는 수준을 넘어, “스킬을 만드는 스킬”, “스킬을 검증하는 스킬”, “모든 스킬을 실행하는 스킬”을 구축함으로써 프로젝트 표준(Standards)을 일관성 있게 유지하고 컨텍스트(Context) 사용량을 극적으로 절감하는 방법을 다룬다. 이 시스템은 Anthropic의 오픈소스 스킬 아키텍처를 기반으로 하며, Cursor나 Antigravity 같은 다른 AI 인터페이스에서도 동일하게 적용 가능하다.

Progressive Disclosure - 스킬 시스템의 핵심 원리

단계적 정보 공개가 가져오는 혁신

스킬 시스템을 이해하기 위해서는 먼저 Progressive Disclosure(단계적 공개) 개념을 이해해야 한다. 이는 AI에게 정보를 단계적으로 제공함으로써 컨텍스트 윈도우(Context Window)를 효율적으로 사용하는 전략이다. MCP(Model Context Protocol) 같은 기존 도구들이 필요한 모든 요소를 한 번에 컨텍스트 윈도우에 덤핑(Dumping)하는 것과 달리, 스킬은 필요한 순간에만 필요한 정보를 로딩한다.

강연자는 공식 문서를 참조하며 스킬의 3단계 레벨 구조를 설명했다. 이 구조를 이해하면 왜 많은 기능들이 MCP에서 스킬로 이전되고 있는지, 그리고 어떤 상황에서 스킬을 사용해야 하는지 명확히 알 수 있다.

Level 1: FrontMatter - 항상 로딩되는 메타데이터

모든 스킬은 Markdown 파일로 작성되며, FrontMatter와 Markdown 본문으로 구성된다. FrontMatter는 Level 1에 해당하며, 여기에는 스킬의 이름(Name)과 설명(Description)이 들어간다. 이 부분은 항상 컨텍스트 윈도우에 로딩되기 때문에 AI가 어떤 스킬을 사용할지 결정하는 핵심 요소가 된다.

강연자는 이 부분에 “힘을 진짜 많이 쏟아야 한다”고 강조했다. 왜냐하면 FrontMatter가 정확하게 작성되어야 AI가 적절한 스킬을 선택할 수 있고, 동시에 컨텍스트를 획기적으로 절감할 수 있기 때문이다. MCP는 등록된 모든 도구의 정보를 컨텍스트에 올리지만, 스킬은 FrontMatter만 로딩하므로 100개의 스킬을 등록해도 컨텍스트를 거의 차지하지 않는다. 이를 위해 FrontMatter는 100 토큰 이하로 작성해야 한다는 명확한 제약이 있다.

Level 2: Markdown Body - 트리거 시점에만 로딩

Markdown 본문은 Level 2에 해당하며, 스킬이 트리거(Trigger)되기 전까지는 컨텍스트 윈도우에 올라가지 않는다. AI가 FrontMatter를 보고 “이 스킬을 사용해야겠다”고 결정한 순간에만 본문을 읽는다. 이를 통해 실제로 사용하지 않는 스킬의 상세 정보를 컨텍스트에 넣지 않아도 되므로 토큰을 대폭 절감할 수 있다.

다만 Markdown 본문도 무제한으로 작성할 수 있는 것은 아니다. 5,000 토큰 이하로 제한되어 있어, 모든 정보를 한 파일에 몰아넣는 것을 방지한다. 그렇다면 5,000 토큰을 넘는 정보를 제공하고 싶을 때는 어떻게 해야 할까? 여기서 Level 3 이상의 구조가 등장한다.

Level 3 이상: 레퍼런스 파일 - 필요 시점에만 탐색

Level 3는 Skill.md 본문에서 직접 참조(Reference)한 다른 파일들을 의미한다. 이 파일들은 스킬을 사용하기로 결정한 후에도 바로 읽지 않는다. AI가 스킬 본문을 읽다가 “이 파일 레퍼런스를 확인해야겠다”고 판단한 순간에만 해당 파일을 찾아가서 읽는다. 만약 Level 3 파일 안에 또 다른 파일 레퍼런스가 있다면 Level 4, 5, 6으로 깊이(Depth)가 계속 깊어질 수 있다.

강연자는 예제, 특정 조건 발동 시 실행되는 코드, 다른 스킬에 대한 레퍼런스 같은 정보는 항상 읽어야 하는 것이 아니기 때문에 진짜 필요한 순간에만 컨텍스트에 담도록 설계해야 한다고 설명했다. 따라서 Level 3를 진짜 잘 설계해야 한다는 것이 핵심이다. 스킬에 공통되는 필수 내용만 Skill.md에 넣고, 나머지는 Level 3 이상으로 분리하는 것이 바람직하다.

메타 스킬 아키텍처 - 3가지 핵심 요소

강연자가 제시한 스킬 시스템은 세 가지 주요 요소로 구성된다. 첫째, 스킬을 만드는 스킬(Manage Skill)이다. 스킬이 많아지면 관리 자체도 자동화해야 하기 때문에 이 메타 스킬이 필요하다. 둘째, 프로젝트의 독립 요소들을 검증하고 문서화하는 스킬(Verify Skills)이다. 도메인 로직, 기술적 구현, 아키텍처 등 프로젝트의 각 부분을 독립적으로 점검하는 역할을 한다. 셋째, 모든 스킬을 중앙에서 실행하고 리포팅하는 스킬(Verify Implementation)이다. 이 스킬은 모든 검증 스킬을 병렬로 실행하여 통합 리포트를 생성한다.

Manage Skill - 스킬 생성과 업데이트의 자동화

Manage Skill은 프로젝트에서 새로운 표준이 생기거나 기존 규칙이 변경될 때 자동으로 Verify 스킬을 생성하거나 업데이트한다. 강연자는 영어로 작성하는 것을 추천했는데, 번역이 빠르고 쉬우며 AI가 더 잘 이해하고 토큰도 적게 소비하기 때문이다. 다만 시연을 위해 한국어로 직역한 버전을 제공했다.

FrontMatter에는 스킬의 이름, 설명(Description), 그리고 Argument Hint가 포함된다. Argument Hint는 스킬을 사용할 때 뒤에 나오는 설명으로, 사용자에게 어떤 인자를 전달해야 하는지 안내한다. Manage Skill의 본문에는 다음과 같은 고수준(High Level) 정의가 담겨 있다.

  • 어떤 Verify 스킬에도 포함되지 않은 변경된 파일 확인
  • 삭제되거나 이동된 파일을 다루는 스킬 확인
  • 기존 검사에서 다루지 않은 새로운 패턴이나 규칙 감지
  • 더 이상 일치하지 않는 설정값 또는 탐지 명령어 삭제/수정

특히 중요한 섹션은 “등록된 검증 스킬” 테이블이다. Verify Implementation에도 동일한 테이블이 있는데, 스킬을 만들 때마다 Manage Skill을 통해 이 테이블에 자동으로 등록되고 각 스킬의 역할이 정리된다. 이를 통해 모든 Verify 스킬을 일괄적으로 관리할 수 있다.

Manage Skill의 또 다른 핵심 기능은 새로운 스킬을 생성할지, 기존 스킬을 업데이트할지 결정하는 것이다. 강연자는 단순한 로직(Logic)을 제시했다. 기존 스킬의 도메인과 관련된 파일이 있으면 기존 스킬을 업데이트하고, 그렇지 않으면 새로운 스킬을 생성한다. 어느 쪽도 해당하지 않으면 스킬을 만들거나 업데이트할 필요가 없다고 판단한다.

스킬을 생성하거나 업데이트할 때는 사용자에게 확인(Confirm)을 받도록 리포트를 만들어 물어보지만, AI가 에이전트(Agentic) 관점에서 확실하다고 판단하면 확인 없이 진행할 수도 있다. 기존 스킬 업데이트 시 적용할 룰(Rule)과 새 스킬 생성 시 따라야 할 규칙도 명시되어 있으며, 가장 대표적인 규칙은 모든 검증 스킬의 이름이 “Verify”로 시작해야 한다는 것이다. FrontMatter 생성 방법과 스킬의 형태도 모두 정의되어 있어, 일관된 구조의 스킬이 자동으로 만들어진다.

Verify Implementation - 모든 검증 스킬의 중앙 실행 허브

Verify Implementation 스킬은 Verify로 시작하는 모든 스킬을 불러와서 병렬로 실행하는 통합 검증 스킬이다. 강연자의 프로젝트에는 18개의 Verify 스킬이 있으며, 이 스킬 하나만 실행하면 모든 검증이 백그라운드에서 병렬로 수행된다.

💡 [영상 참조] 강연자는 이 시점에서 화면에 표시된 실행 로그와 리포트를 참조하며 설명합니다. 상세 내용은 원본 영상을 확인하세요.

실행이 완료되면 체크 사항들을 정리한 리포트가 생성되고, 어떤 이슈를 고쳐야 하는지 정리된다. 이 리포트를 바탕으로 각 이슈에 대한 설명을 요청하거나, 특정 이슈만 선택적으로 수정하도록 명령할 수 있다.

Verify Implementation 스킬은 Manage Skill에서 정의한 스탠다드(Standard)를 따르므로, 새로운 Verify 스킬이 추가되어도 통합 리포팅이 자연스럽게 이루어진다. Verify Implementation의 “등록된 검증 스킬” 테이블에는 실행해야 할 모든 스킬이 명시되어 있어, 별도로 탐색할 필요 없이 테이블만 참조하면 된다.

실전 활용 워크플로우

스킬 사용의 실제 프로세스

스킬을 사용하는 방법은 간단하다. Slash Command로 /manage-skill을 입력하고, 필요하다면 추가로 넣고 싶은 요소를 직접 입력한다. 만약 현재 세션에서 이미 작업을 진행했다면, “현재 작업한 세션 히스토리를 확인하고 저장해야 할 요소들을 추려달라”고 요청하면 된다. 그러면 AI가 자동으로 Verify 스킬을 만들고, 해당 스킬의 메타데이터를 추가해야 할 영역(Manage Skill과 Verify Implementation의 테이블)을 자동으로 수정한다.

강연자는 이 프로젝트를 GitHub에 무료로 공개할 예정이며, 사용자는 해당 프로젝트를 복사하여 자신의 프로젝트에 붙여넣기만 하면 된다. 이후 Manage Skill로 스킬을 생성하고, Verify Implementation으로 검증을 수행하면 된다.

초반의 귀찮음과 장기적 이득

초반에는 작업할 때마다 Manage Skill을 실행해서 스킬을 업데이트해야 하므로 다소 번거로울 수 있다. 그러나 프로젝트가 커질수록 Verify 스킬들이 프로젝트의 각 부분을 세세하게 체크해주고, 사람이 기억하지 못하는 검증 항목까지 자동으로 확인해주기 때문에 규격이 점점 더 잘 잡히는 체감을 받게 된다.

특히 코딩 스탠다드에서 벗어나거나 아키텍처가 망가지기 시작했을 때 이 스킬셋을 사용하면 한 방에 구도를 다시 잡을 수 있다. 이미 문제가 많아진 상황에서 사용하는 것보다, 자주 사용해서 규격을 유지하는 것이 훨씬 효율적이다. 강연자는 푸쉬(Push) 전에 최소한 한 번씩 실행할 것을 권장했다. 리포트가 나왔을 때 문제가 있으면 “우리 스탠다드대로 고쳐”라고 한마디만 하면 되므로, 사용자는 큰 이득을 볼 수 있다.

프로젝트 전반 관리의 새로운 패러다임

Quality Management와 Documentation의 통합

강연자가 제시한 스킬 시스템은 단순한 자동화 도구를 넘어 Quality Management(품질 관리)와 Documentation(문서화) 도구의 통합이다. Vibe Coding으로 AI에게 작업을 시킬 때마다 발생하는 새로운 지식과 기준들을 스킬에 축적함으로써, 프로젝트 전반의 표준을 일관되게 유지할 수 있다.

이 시스템의 가장 큰 장점은 컨텍스트를 극강으로 아낄 수 있다는 것과 여러 세션에 걸쳐 사용해도 프로젝트 스탠다드를 거의 완벽하게 지킬 수 있다는 것이다. 새로운 기능이 추가될 때마다 Verify Implementation 스킬을 실행하면, 프로젝트 전반의 스탠다드가 맞는지 한 번에 확인할 수 있다.

프레임워크 스탠다드, 캐싱, 마이그레이션 관리

강연자는 이 시스템으로 프레임워크 스탠다드, 캐싱 정책, 포인트 시스템, 마이그레이션(Migration) 스탠다드 등을 관리한다고 밝혔다. Vibe Coding으로 작업할 때마다 발생하는 새로운 지식과 기준을 Verify 스킬에 추가하면, 토큰을 거의 소비하지 않으면서도 지속적으로 관리할 수 있다.

정리만 잘 해두면, Progressive Disclosure의 원리에 따라 필요한 순간에만 필요한 정보가 로딩되므로 컨텍스트 부담 없이 프로젝트 전체를 체계적으로 관리할 수 있다. 강연자는 코딩 스탠다드, 아키텍처, 테스트 커버리지 같은 항목들을 확인하고 싶을 때 “스킬 하나만 실행하면 프로젝트 전반적으로 점검이 다 된다”고 강조했다.

마무리 - 스킬 기반 자동화의 미래

이번 강연은 단순히 스킬을 사용하는 방법을 넘어, 스킬 자체를 관리하고 검증하고 실행하는 메타 구조를 구축하는 방법을 보여주었다. Progressive Disclosure 원리를 깊이 이해하고 Level 1(FrontMatter), Level 2(Markdown Body), Level 3 이상(레퍼런스 파일)의 구조를 적절히 설계하면, 컨텍스트 사용량을 획기적으로 줄이면서도 프로젝트 전반의 품질을 자동으로 유지할 수 있다.

Manage Skill로 스킬을 자동 생성 및 업데이트하고, 개별 Verify 스킬로 각 도메인을 독립적으로 검증하며, Verify Implementation으로 모든 검증을 통합 실행하는 3단 구조는 프로젝트가 커질수록 그 진가를 발휘한다. 강연자가 강조한 것처럼, 초반의 약간의 번거로움을 감수하면 장기적으로 코딩 스탠다드와 아키텍처 규격을 일관되게 유지할 수 있으며, 푸쉬 전 한 번의 명령으로 전체 프로젝트를 점검할 수 있다.

이 시스템은 Anthropic의 오픈소스 아키텍처를 기반으로 하므로 Claude Code뿐 아니라 Cursor, Antigravity 등 다른 AI 인터페이스에서도 동일하게 적용할 수 있다. 강연자가 GitHub에 공개할 예정인 프로젝트를 활용하여, 자신의 프로젝트에 맞게 변형하고 확장해 나가면 AI 기반 개발 워크플로우의 새로운 차원을 경험할 수 있을 것이다.

📚 출처 및 참고

구분내용
원본 영상코팩의 두번째 선물. 스킬을 검증하고, 스킬을 만들고, 스킬을 실행하는 스킬 무료 배포
채널코드팩토리
리포트 작성2026-02-13
작성 방식YouTube 영상 STT 변환 후 에디팅

💬 본 리포트는 영상 내용을 바탕으로 재구성되었습니다. 정확한 내용은 원본 영상을 참조해 주세요.

그래프 뷰

Related Reports

백링크