cc-skills-golang: AI 코딩 에이전트를 위한 프로덕션 Go 개발 스킬 모음

9bow · 6월 26, 2026, 4:30오전

cc-skills-golang 소개

AI 코딩 에이전트는 범용 지식은 풍부하지만, 특정 언어의 관례나 프로덕션 환경에서 통하는 세부 규칙까지는 일관되게 지키지 못하는 경우가 많습니다. 이를 보완하는 방법이 에이전트 스킬(agent skill)입니다. 스킬은 코딩 도우미에 도메인별 전문성을 더하는 재사용 가능한 지시 모음으로, 필요할 때만 로드되어 컨텍스트를 불필요하게 채우지 않습니다. cc-skills-golang은 이 스킬을 Go 언어에 특화해 모아둔 저장소입니다.

cc-skills-golang은 Go에 한정된 스킬만 다룹니다. 언어 관례, 테스트, 보안, 관측성(observability) 같은 영역이 여기에 속하며, git 컨벤션이나 CI/CD, PR 리뷰 같은 범용 개발 워크플로우 스킬은 별도의 cc-skills 저장소에서 다룹니다. 각 스킬은 서로를 참조하는 원자적 단위로 설계되어 있어서, 일부만 설치하면 부분적이고 일관성이 떨어지는 결과가 나올 수 있습니다. 그래서 범용 스킬은 함께 설치하는 편이 권장됩니다.

이 저장소가 다른 자동 생성 스킬 모음과 구분되는 지점은 제작 방식입니다. 저자는 자신의 Go 프로젝트 커밋을 Claude Code로 정제해 초안을 만든 뒤, "여기에 AI 슬롭은 없다. AI가 만든 스킬은 쓸모없다" 라는 원칙 아래 사람이 직접 편집·테스트·리뷰·재작업했다고 밝히고 있습니다. 본 게시물에서는 cc-skills-golang의 스킬 구성과 평가 결과, 그리고 여러 코딩 에이전트에 설치하는 방법을 정리합니다.

cc-skills-golang의 스킬 구성

cc-skills-golang의 스킬은 크게 범용 스킬과 프레임워크·라이브러리 스킬로 나뉩니다. 범용 스킬은 코드 품질, 아키텍처·설계, QA·성능, 프로젝트 시작의 네 묶음으로 구성되고, 프레임워크 스킬은 API, 의존성 주입, 프레임워크, samber 라이브러리, 테스트 도구를 다룹니다.

                         ┌────────────────────────────────────────┐
                         │             Golang Skills              │
                         └──────────────────┬─────────────────────┘
                                            │
   ┌─────────────────┬──────────────────────┼──────────────────────┐
   ▼                 ▼                      ▼                      ▼
┌──────────────┐ ┌──────────────┐ ┌─────────────────┐ ┌──────────────────┐
│ Code Quality │ │ Arch & Design│ │    QA & Perf    │ │  Project Start   │
├──────────────┤ ├──────────────┤ ├─────────────────┤ ├──────────────────┤
│ code-style   │ │ design-patt  │ │ testing         │ │ project-layout   │
│ naming       │ │ concurrency  │ │ benchmark       │ │ popular-libs     │
│ error-handl  │ │ context      │ │ performance     │ │ cli              │
│ safety       │ │ dep-inject   │ │ troubleshoot    │ │ CI               │
│ structs-iface│ │ data-structs │ │ observability   │ │ stay-updated     │
│ documentation│ │ database     │ │                 │ │ dep-management   │
│ lint         │ │ modernize    │ │                 │ │                  │
│ security     │ │              │ │                 │ │                  │
└──────────────┘ └──────────────┘ └─────────────────┘ └──────────────────┘

각 스킬에는 토큰 가중치가 표기되어 있습니다. 스킬 트리거 판단을 위해 항상 로드되는 description 필드, 스킬이 실제로 발동될 때 로드되는 SKILL.md 전체, 그리고 참조 문서를 포함한 디렉토리 전체의 토큰량이 각각 명시됩니다. 점진적 공개(progressive disclosure) 구조 덕분에 평소에는 가벼운 설명만 로드되고, 작업이 해당 스킬과 맞을 때만 본문이 펼쳐집니다. 저자는 추천() 스킬만 켜둘 경우 시작 시 로드되는 설명이 약 1,100토큰 수준이며, 전체 본문은 관련 작업이 있을 때만 끌어온다고 설명합니다. 또한 한 세션에서 보통 2~4개 스킬이 동시에 로드되므로, 로드된 SKILL.md 총량을 약 10k 토큰 이하로 유지하는 것을 권장합니다.

스킬마다 부가 플래그가 붙습니다. 는 추천 스킬, 는 전용 명령(command) 제공, 는 자동으로 깊이 추론(ultrathink)을 켜는 스킬, 는 회사나 팀 자체 규칙으로 덮어쓸 수 있는(overridable) 스킬을 뜻합니다. 프레임워크와 라이브러리 스킬로는 gRPC, GraphQL, Swagger, google-wire, uber-dig, uber-fx, spf13-cobra, spf13-viper, 그리고 저자가 만든 samber 계열 라이브러리(lo, mo, ro, do, hot, slog, oops)와 stretchr-testify 등이 포함됩니다. 이와 별개로 golang-pkg-go-dev 스킬은 pkg.go.dev API 클라이언트인 godig(CLI 및 MCP 서버)를 통해 Go 패키지 문서, API 레퍼런스, 버전, 알려진 취약점 등을 조회합니다.

cc-skills-golang의 평가 결과

저자는 스킬 적용 전후를 비교한 평가 결과를 함께 공개합니다. 저장소의 EVALUATIONS.md에 따르면, 전체 평가에서 스킬을 적용한 경우 3,315/3,395(98%)가 통과했고, 적용하지 않은 경우 1,915/3,395(56%)에 그쳐 약 41%p 차이가 났습니다.

개별 스킬 단위로도 오류율 감소폭이 표로 제시됩니다. 예를 들어 의존성 주입 라이브러리를 다루는 golang-samber-do 는 오류율 격차가 -81%, 코드 현대화를 다루는 golang-modernize 는 -61%, 문서화를 다루는 golang-documentation 은 -53%로 보고됩니다. 수치는 저장소가 제시한 자체 평가 기준에 따른 값이므로, 실제 환경에서의 효과는 프로젝트 성격에 따라 달라질 수 있습니다.

cc-skills-golang 설치 방법

가장 보편적인 설치 방법은 skills CLI를 쓰는 것입니다. Agent Skills 호환 도구라면 모두 동작합니다.

# 전체 스킬 설치
npx skills add https://github.com/samber/cc-skills-golang --all

# 단일 스킬만 설치
npx skills add https://github.com/samber/cc-skills-golang --skill golang-performance

Claude Code에서는 플러그인 마켓플레이스로 설치할 수 있습니다.

/plugin marketplace add samber/cc
/plugin install cc-skills-golang@samber

이 외에도 Openclaw, Gemini CLI(gemini extensions install), Cursor, Copilot, OpenCode, Codex, Antigravity 등 여러 도구를 지원합니다. 대부분은 각 도구의 스킬 탐색 디렉토리(예: ~/.agents/skills/, ~/.cursor/skills/)에 저장소를 클론하면 자동으로 인식됩니다.

CI에서 AI 기반 코드 리뷰에 활용하기

cc-skills-golang은 로컬 개발뿐 아니라 CI 파이프라인에서 AI 에이전트를 PR 리뷰어로 투입하는 용도로도 쓸 수 있습니다. 이 스킬 플러그인을 연결하면 에이전트가 리뷰 영역에 맞는 Go 스킬을 적용해, 린터가 잡지 못하는 아키텍처 일탈, 로직 버그, 동시성 위험 같은 문제를 기존 정적 분석과 함께 점검합니다. 저자는 Claude Code Action과 GitHub Copilot용 설정 방법을 GOLANG-AI-DRIVEN-REVIEW.md에 정리해 두었습니다.

cc-skills-golang의 라이선스

cc-skills-golang은 MIT 라이선스로 공개되어 있어 개인 및 상업적 목적으로 자유롭게 사용할 수 있습니다.

cc-skills-golang 스킬 카탈로그

cc-skills-golang 프로젝트 GitHub 저장소

더 읽어보기

이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다.

파이토치 한국 사용자 모임이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일로 보내드립니다!
텔레그램(Telegram)이나 Slack/Discord/Teams/Dooray/GoogleChat 등으로도 새 글 알림을 받으실 수 있습니다.

아래쪽에 좋아요를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~