동료인 @masa-asa 님이 AI를 활용한 개발에 「한 명의 엔지니어」가 마주하며 실천하고 있는 3가지 메커니즘이라는 글을 올렸습니다.

솔직히 대단하다고 생각하면서도, 솔직한 마음은 이렇습니다.

「그렇게까지 깔끔하게 설계할 기력, 나에게는 없어...! 아니, 가능하다면 스킬 그 자체에 시간을 쓰고 싶지 않아...!」

그렇게 자포자기해 버린 것이 이번 「게으른 AI 주도 개발」의 시작입니다. 세상에는 이미 수많은 사람이 스킬을 만들어 공개해 주고 있습니다. 그렇다면 그것을 가져와서 자신에게 맞게 수정하면 되지 않을까...! 과연 이 요령 피우기가 잘 통할까요?

• Claude Code

직접 제로(0)부터 쓰는 대신, 우선은 기존의 스킬이 모여 있는 곳을 살펴보러 갑니다.

둘 다 커뮤니티가 만든 스킬이나 인스트럭션 (Instructions)이 줄지어 나열되어 있는 사이트입니다. 「Git의 커밋 메시지를 정리하는 스킬」, 「문서를 자동 생성하는 스킬」 등 업무에서 자주 발생하는 「귀찮은 일」들이 한데 모여 있습니다.

NOTE

Awesome GitHub Copilot은 agents · instructions · skills · plugins 등 카테고리별로 정리되어 있으며, GitHub Copilot용이긴 하지만 스킬의 내용 (SKILL.md) 자체는 Claude Code에서도 그대로 사용할 수 있는 것이 많습니다.

기쁜 점은 두 사이트 모두 명령어 한 번으로 설치할 수 있는 수단을 제공하고 있다는 것입니다.

WARNING

배포되는 스킬에는 프롬프트 인젝션 (Prompt Injection, 악의적인 지시가 매립될 리스크)이 잠재되어 있을 가능성이 있습니다. 설치하기 전에 SKILL.md 등 내용을 반드시 살펴보고, 수상한 지시가 포함되어 있지 않은지 확인한 후 사용합시다.

# Awesome GitHub Copilot의 스킬을 설치
# 예) conventional-commit
gh skills install github/awesome-copilot conventional-commit
...

두 명령어 모두 제대로 .claude/skills/ 하위에 스킬을 배치해 줍니다. 「손을 움직이지 않는다」라는 게으름의 정수가 벌써 여기서 실현되었습니다.

드디어 스킬을 사용하기 시작하자마자 곧바로 벽에 부딪혔습니다.

「어라, 일본어로 대화하고 있는데 왜 이 녀석 갑자기 영어를 쓰는 거지...?」

그렇습니다. Claude Code가 출력하는 프롬프트 (Prompt)나 코멘트 (Comment)가 영어가 되는 것입니다.

원인은 단순했습니다. 가져온 스킬의 내용 (SKILL.md)이 애초에 영어로 작성되어 있었기 때문입니다. 스킬의 지시가 영어라면, Claude Code도 그 문맥에 끌려가 영어로 응답하기 쉬워진다는 것입니다.

.claude/settings.json에 기본 언어를 설정합니다.

{
"$schema": "https://json.schemastore.org/claude-code-settings.json",
"language": "japanese"
...
}

이렇게 설정했더니, 스킬의 내용이 영어라도 출력 자체는 제대로 일본어로 나오게 되었습니다.

「됐다, 이걸로 해결...」

그렇게 생각하던 찰나, 사건은 아직 끝나지 않았습니다.

언어 설정을 하고 만족하고 있던 중, conventional-commit 스킬을 사용하여 커밋을 만들어 보니 커밋 메시지가 완강하게 영어인 채로 나오는 것입니다.

「settings.json에서 일본어로 설정했을 텐데...?」

곰곰이 생각해 보니, language 설정은 어디까지나 대화로서의 출력 언어였으며, conventional-commit 스킬이 가지고 있는 「커밋 메시지 포맷」 자체는 스킬 안의 영어 지시 · 샘플에 강하게 끌리고 있었던 모양입니다. 즉, 언어 설정과 스킬 고유의 규칙은 별개였다는 뜻입니다 (눈물).

그래서 CLAUDE.md에 「커밋 메시지는 일본어로 작성할 것」이라는 방침을 명시하여, conventional-commit 스킬이 가진 영어 규칙을 덮어쓰는 형태로 대응했습니다.

## 스킬 사용 시의 규칙
### conventional-commit 스킬 사용 시의 규칙
- type, scope 는 영어 (feat, fix, docs 등)
...

가져온 스킬을 「참고서」로 취급하여, 그중에서 자신들의 방식에 맞는 부분만 추출해 CLAUDE.md에 반영한다. 완전히 처음부터 작성하는 것보다 훨씬 에너지 절약형이며, 게다가 핀포인트로 수정하고 싶은 부분에만 손을 댈 수 있었다.

최종적으로는 다음과 같은 운영 방식으로 정착되었습니다.

• 스킬은 기본적으로 가져온다 (awesome-copilot / skills.sh)
• 언어 관련 토대는 settings.json에서 일괄 대응
• 스킬별 세부적인 습관(커밋 메시지 등)은 CLAUDE.md에서 스킬의 규칙을 덮어쓰기(overwrite)

「스킬을 직접 만든다」도 「스킬의 내용을 통째로 고쳐 쓴다」도 아닌, 외부 레이어(settings.json, CLAUDE.md)에서 조정한다는 타협점에 도달한 느낌입니다.

솔직히 처음에는 「스킬이란 직접 만드는 것」이라는 고정관념이 있었지만, 막상 「가져와서 수정한다」는 방향으로 몰두해 보니 상상 이상으로 쾌적했습니다. 특히 영어 프롬프트 문제나 커밋 메시지의 언어 문제는 혼자서 고민했다면 꽤 많은 시간을 허비했을 것입니다.

마찬가지로 「스킬 만드는 거 귀찮은데...」라고 생각하시는 분들은, 우선 배포 사이트를 살펴보는 것부터 시작해 보시는 건 어떨까요? 여러분의 「게으른 AI 주도 개발」 지식도 꼭 공유해 주세요!