지난주 Chris Banes — 네, Google의 Android 팀에서 근무하는 바로 그 Chris Banes입니다 — 가 Kotlin, Jetpack Compose, 그리고 Android를 대상으로 하는 Claude Code skills의 공개 리포지토리(repo)를 게시했습니다. 저는 저녁 시간을 할애하여 이를 살펴보았고, 여기에 대해 쓸 만한 가치가 있는 내용이 충분히 들어있다는 것을 발견했습니다. 리포지토리에 있는 모든 skill을 실전에서 테스트했다고 거짓말하지는 않겠습니다. 하지만 저는 지난 몇 달 동안 백엔드 작업을 위해 Claude Code skills를 사용해 왔으며, Android에 대한 깊은 전문 지식을 가진 사람이 자신의 설정을 공개적으로 공유하는 것을 보는 것은 분석할 가치가 있는 유용한 신호입니다.

Claude Code skills란 무엇인가?
리포지토리 자체를 살펴보기 전에 빠르게 복습해 보겠습니다. Skills는 .claude/skills/ 디렉토리에 넣는 재사용 가능한 지침 파일(instruction files)입니다. Claude는 이를 자동으로 인식하며, 설명(description)이 사용자가 하려는 작업과 일치할 때 관련 skill을 호출합니다. 공식 문서에서 형식을 더 자세히 다루고 있습니다. 전형적인 skill 파일 구조는 다음과 같습니다:

---

name : my-skill-name
description : "이 skill을 언제 사용하는지 — Claude가 결정을 내리기 위해 읽는 내용"

Skill instructions

모델을 위한 단계별 안내...

이것이 전부입니다. name과 description이 포함된 프론트매터(Frontmatter), 그리고 일반 마크다운(markdown) 지침이 전부입니다. 작성하기 쉽고 공유하기도 쉽습니다.

이것이 왜 이전의 스니펫(snippets) 붙여넣기 방식보다 나은가
skills를 사용하기 전에는 Claude에게 "우리가 여기서 일하는 방식"을 공유하는 방법으로 CLAUDE.md 파일을 사용하거나, 매 세션 시작 시 컨텍스트(context)를 그냥 붙여넣는 방식을 사용했습니다. 둘 다 작동하지만 각각 트레이드오프(tradeoffs)가 있습니다. CLAUDE.md는 매번 로드되므로, 컨벤션(conventions)이 적용되지 않는 작업에서도 컨텍스트를 비대하게 만듭니다. 컨텍스트를 수동으로 붙여넣는 것은 그중 절반을 잊어버리게 된다는 것을 의미합니다. Skills는 그 중간 어디쯤에 위치합니다. 사용 가능하지만 관련이 있을 때만 불러옵니다. 특히 Android 작업의 경우, 이는 생각보다 더 중요합니다. Compose는 컨텍스트에 따라 상태(state)를 처리하는 합리적인 방법이 적어도 세 가지가 있으며, 명시적인 안내 없이 Claude가 올바른 방법을 선택하도록 하는 것은 복불복입니다.

실제 예시
제가 리스트와 상세 보기(detail view)가 있는 화면을 스캐폴딩(scaffolding)한다고 가정해 보겠습니다.

가이드가 없다면, Claude는 제가 실제로 원했던 것이 rememberSaveable임에도 불구하고 ViewModel 안에 완벽하게 유효한 MutableStateFlow를 반환할 수도 있습니다. 상태가 구성 변경(config changes) 시에도 유지되어야 하지만 다른 곳에 존재할 필요는 없는 상황이라면 더욱 그렇습니다. 이를 위한 스킬(skill) 파일은 다음과 같은 모습일 것입니다:

---

name : compose-state-decisions
description : Compose UI 상태를 스캐폴딩(scaffolding)할 때 사용

— Compose에서 상태 홀더(state holders)를 선택할 때:

• remember : 일시적인(ephemeral) UI 상태 (확장/축소 등)
• rememberSaveable : 구성 변경(config changes) 시에도 유지되어야 하는 상태
• ViewModel 상태: 화면 간에 공유되거나 프로세스 종료(process death) 시에도 유지되는 상태

상태가 다른 곳에서 관찰(observe)될 필요가 없다면, 화면 로컬 상태에 대해서는 ViewModel보다 rememberSaveable을 선호하세요.

이것이 바로 스킬이 제 역할을 하는 방식입니다. 여러분은 단순히 코드를 작성하는 것이 아니라, Claude가 여러 세션에 걸쳐 일관되게 적용할 수 있는 판단력(judgment)을 인코딩하는 것입니다.

설정 방법

프로젝트의 skills 디렉토리로 클론(cloning)하는 것이 가장 당연한 첫 번째 단계입니다:

# Android 프로젝트 루트에서
mkdir -p .claude/skills
cd .claude/skills

# 리포지토리를 가져오거나(또는 원하는 특정 스킬만 복사)
git clone https://github.com/chrisbanes/skills.git

그 후, Claude Code는 다음 세션에서 이 스킬들을 인식할 것입니다. Claude에게 사용 가능한 스킬이 무엇인지 물어봄으로써 이를 확인할 수 있습니다.

한 가지 권장하고 싶은 점은, 단순히 전체를 다 쏟아붓고 잊어버리지 마라는 것입니다. 스킬 설명을 읽어보고, 어떤 것이 실제 팀의 작업 방식과 일치하는지 결정한 다음, 맞지 않는 것들은 가지치기(prune)하세요. 사용하지 않는 스킬은 관련성 점수(relevance scoring)를 흐트러뜨리는 노이즈가 될 수 있습니다.

이 패턴이 유망한 이유

Chris의 리포지토리에서 흥미로운 점은 특정 스킬 그 자체라기보다, 뛰어난 Android 전문성을 가진 누군가가 이를 공개적으로 공유하고 있다는 사실입니다. 이는 다른 사람들이 이를 포크(fork)하거나, 적응시키거나, 혹은 스킬을 잘 구조화하는 방법으로부터 배울 수 있음을 의미합니다. 저는 다른 생태계에서도 이런 모습이 더 많이 보이기를 바랍니다. 예를 들어 Rust의 비동기 패턴(async patterns)을 위한 스킬 리포지토리 같은 것 말이죠.

Spring Boot 컨벤션(conventions)을 위한 것, React Server Components의 주의사항(gotchas)을 위한 것 등이 있을 수 있습니다. 이 모델은 이식 가능하며, 참조 예시가 많아질수록 모두의 스킬(skills)은 더 좋아집니다. 몇 주 전 저는 저희 팀의 내부 컨벤션을 위한 스킬들을 작성하기 시작했는데, Chris가 사용하는 형식은 제가 해오던 방식보다 더 간결했습니다. 짧은 설명, 명확한 사용 시점(when-to-use) 가이드, 최소한의 산문(prose). 저는 이번 주에 제 것들을 리팩터링(refactor)할 예정입니다.

주의해야 할 사항들
실제 프로젝트에서 스킬을 실행하며 맞닥뜨린 몇 가지 사항들입니다:

스킬 설명이 본문보다 중요합니다. Claude는 스킬을 호출할지 결정하기 위해 설명을 사용합니다. 모호한 설명은 스킬이 절대 실행되지 않는 결과로 이어집니다.

중복되는 스킬은 이상한 동작을 유발합니다. 만약 두 개의 스킬이 모두 Compose 상태(state)를 처리한다고 주장하면, 일관되지 않은 호출이 발생할 것입니다.

범위(scope)에 대해 냉정해지세요. 프로젝트 특화형이 일반적인 것보다 낫습니다. "클린 아키텍처(clean architecture)를 사용하라"고 말하는 스킬은 너무 광범위해서 유용하지 않습니다. 반면 "네트워크 호출에는 우리의 Result<T> 타입을 사용하라"고 말하는 스킬은 훨씬 더 효과적입니다.

또한 작은 도구 관련 이야기인데, 만약 팀 전체에서 스킬이 얼마나 자주 사용되는지 추적하고 싶다면(또는 GDPR 쿠키 배너 문제를 피하면서 개발 블로그의 분석 데이터를 얻고 싶다면), Umami나 Plausible 같은 개인정보 보호 중심의 옵션들이 Google Analytics보다 훨씬 가벼운 발자국과 완전한 데이터 소유권을 제공합니다. 저는 작년에 두 개의 사이드 프로젝트를 Umami로 이전했고, 다시는 돌아보지 않았습니다.

이 리포지토리를 사용해야 할까요?
만약 당신이 Android, Kotlin, 또는 Compose 코드를 작성하고 있으며 이미 Claude Code를 사용하고 있다면, 네 — 최소한 한 번 살펴보세요. 스킬들을 통째로 채택하지 않더라도, 그것들이 작성된 방식의 패턴은 배울 가치가 있습니다. 만약 Android 작업을 위해 아직 Claude Code를 사용하지 않고 있다면, 이 리포지토리는 이를 시도해 볼 만한 합리적인 계기가 될 것입니다. 당신의 CLAUDE.md와 함께 사용한다면, 끊임없는 관리(babysitting) 없이도 당신의 컨벤션을 존중하는 환경을 구축할 수 있습니다.

실제 기능(feature)을 구현하며 이만큼 충분히 테스트해보지는 않았기에 거창한 주장을 하지는 않겠습니다. 아마도 사소하지 않은 작업에 몇 주 동안 사용해 본 뒤에 후속 글을 작성하게 될 것 같습니다. 하지만 초기 신호는 긍정적입니다. 스킬(skill) 형식은 매우 단순하여, 설령 Chris의 리포지토리(repo)가 당신의 프로젝트에 완벽하게 들어맞지 않더라도 당신만의 스킬을 작성할 수 있는 명확한 템플릿을 제공합니다. 리포지토리를 직접 확인해 보세요: github.com/chrisbanes/skills .