Claude Code 스킬 만들기 — 나만의 AI 명령어 만드는 법

같은 프롬프트를 하루에 12번 복붙하고 있었다. “감점제로 채점해. 칭찬 금지.” — 매번 타이핑하다 보니 하루 20분이 반복 입력에 날아갔다. Claude Code 스킬은 이 반복을 /review 한 줄로 끝내는 기능이다. 마크다운 파일 하나로 만들 수 있다. 나도 코드 리뷰 프롬프트를 매번 치다가 스킬로 만든 뒤 하루 작업 시작이 10초로 줄었다. 실제로 만든 brutal-review 스킬의 과정을 공개한다.

왜 스킬이 필요한가

같은 지시를 5번 이상 반복하고 있다면
스킬로 만들 때다.

예시:
- 코드 리뷰할 때마다 “감점제로 채점해줘” → /review
- 글 쓸 때마다 “AI 클리셰 확인해줘” → /cliche-check
- 커밋할 때마다 “커밋 메시지 만들어줘” → /commit

반복 지시 = 스킬 후보.

스킬 만드는 법 — 3단계

1단계: 폴더 생성

mkdir -p ~/.claude/skills/my-skill

2단계: SKILL.md 작성

~/.claude/skills/my-skill/SKILL.md 파일을 만든다:

---
name: my-review
description: 감점제 코드 리뷰
---

너는 코드를 채점하는 심판이다.
10점 만점에서 감점만 한다.
가산점은 없다.
칭찬은 금지다.

이게 전부다. 마크다운 파일 1개.

3단계: 사용

Claude Code에서 /my-review를 입력하면
위 지시문이 자동으로 적용된다.

실전 — brutal-review 스킬

실제로 만들어서 GitHub에 공개한 스킬이다.

구조

~/.claude/skills/brutal-review/
└── SKILL.md

SKILL.md 핵심

  • 소련 올림픽 심판 캐릭터
  • 코드 7개 카테고리 (구조, 보안, 가독성…)
  • 글 5개 카테고리 (논리, 근거, 명확성…)
  • 감점 등급: -0.2, -0.3, -0.5
  • 채점표 출력 형식

사용법

/brutal-review src/auth.ts

결과

감점 사유 목록 + 점수 + 총평이 나온다.
“잘 짰습니다”는 어디에도 없다.

남이 만든 스킬 가져오기

GitHub에 공개된 스킬을 가져오려면 직접 복사한다:

# 예시: brutal-review 스킬 가져오기
git clone https://github.com/jason-h23/brutal-review ~/.claude/skills/brutal-review

또는 SKILL.md 파일 내용을 복사해서
~/.claude/skills/스킬이름/SKILL.md로 저장하면 된다.

좋은 스킬의 조건

구체적인 행동 규칙.
“좋은 코드를 써줘” X
“함수 50줄 이하, console.log 금지, 에러 처리 필수” O

출력 형식 지정.
“리뷰해줘” X
“카테고리별 점수와 총점을 채점표로 출력해라” O

금지 사항 명시.
칭찬 금지, 칭찬 후 비판 금지 같은
하지 말아야 할 것을 적는 게
해야 할 것을 적는 것보다 효과적이다.

자주 묻는 질문

Claude Code 스킬이 뭔가?

자주 쓰는 지시를 파일로 저장해서
/명령어로 바로 실행할 수 있게 만드는 기능이다.

스킬을 만드는 데 코딩이 필요한가?

마크다운 파일 하나만 쓰면 된다.
코딩이 아니라 “이렇게 행동해라”라는 지시문을 적는 것이다.

지금 해볼 것

mkdir -p ~/.claude/skills/my-first-skill 을 터미널에 치고, SKILL.md 파일에 가장 자주 반복하는 지시 3줄을 적어라. 5분이면 첫 스킬이 만들어진다.

댓글

댓글 쓰기

이 블로그의 인기 게시물

[알고리즘] Suffix Tree

이미지
Suffix tree는 문자열의 모든 접미사들을 표현하는 trie 모양의 자료 구조이다. prefix tree라 불리는 trie가 근간이 되는 자료구조인듯 한데 두 자료구조의 차이는 banana라는 단어가 있을 때 trie는 banana라는 단어만 저장을 하지만 suffix tree는 banana, anana, nana, ana, na, a 와 같이 banana라는 단어에서 나올 수 있는 모든 경우의 수를 다 저장한다는 것이다. 쓸데없이 모든 경우를 저장하는 이유는 문자열에 대한 검색을 할 때 필요하기 때문이다. Trie 자료구조 같은 경우에는 ban, ba와 같은 일부분의 단어로 banana라는 완전한 단어를 찾을 수 있지만 nan, ana와 같은 단어로는 banana를 찾을 수 없다. 이러한 문제를 해결하기위해 trie를 개선시킨 것이 suffix tree인듯 하다.  Suffix trie는 trie에 모든 suffix들을 저장한 구조를 의미한다. 아래 그림은 abaaba라는 문자열 T를 suffix tree에 저장하는 예시이다. suffix tree나 suffix trie에 문자열을 저장할 때는 문자열의 끝에 $를 붙이는데 그 이유는 정확히 모르겠다... 아마 문자열의 끝을 알리기 위한 용도인 것 같다. Suffix Trie의 형태  위 그림의 왼쪽과 같은 모양이 suffix trie이다. 여기서 자식 노드가 1개 뿐인 것들을 합치면 오른쪽과 같은 모양이 되는데 저러한 형태의 자료구조를 suffix tree라 한다. Suffix Tree  이 suffix tree는 문자열의 길이만큼의 leaf node를 갖는다  위 그림에서 오른쪽 그림은 tree의 edge label을 (offset, length)의 형태로 T를 나타낸 것이다. Suffix tree의 label  각 노드의 label은 root로부터 node로 연결된 edge의 label과 ...
자세한 내용 보기

[기타IT] php설치

이미지
 이번에는 php 설치하는 법에 대해 알아보겠습니다. 저는 개발할 때 node.js를 사용 하지만 이번에 프로젝트하는데 필요한 xibo가 php기반이라 설치하게 되었습니다. php란?  php(약칭 : Hypertext Preprocessor)는 프로그래밍 언어의 일종으로 동적 웹 페이지를 만들기 위해 설계되었습니다. php는 일반적으로 혼자 설치되지 않고 apache와 MySql과 함께 설치되는 것이 일반적입니다.  php는 apache를 통해 브라우저로 정보를 전송하고 MySql을 이용해 사용자의 정보를 저장하기 때문에 일반적으로 함께 사용되고 설치됩니다. 이를 APM이라 하는데 Window에 설치하는 APM을 WAPM이라 합니다. 이걸 각각 설치 할 수도 있지만 난이도가 있기 때문에 Bitnami를 이용해 한번에 설치해 보도록 하겠습니다. php설치 먼저 https://bitnami.com/stack/wamp 에 접속하여 설치파일을 다운로드 받습니다.  다운로드가 완료되면 설치파일을 실행합니다. 다른 구성요소들은 굳이 필요하지 않으니 체크박스를 해제해줍니다. php에서 쓰는 MySql의 root사용자 비밀번호를 설정해주는 화면입니다. 6자리 이상의 비밀번호를 입력하시면 됩니다. 설치가 되고 있는 화면입니다.  설치가 완료되고 브라우저 주소창에 localhost를 쳤을 때 다음과 같은 화면이 출력되면 제대로 설치가 된것입니다.
자세한 내용 보기

[Digital Signage] Xibo 설치

이미지
 이번에는 Digital Signage용 오픈소스 OS인 Xibo를 설치하는 방법에 대해 알아보겠습니다. Xibo는 php기반이기 때문이 php가 설치되어 있어야 합니다. php 설치가 필요하신 분들은  http://cd4761.blogspot.kr/2016/02/it-php.html 로 가셔서 설치를 하신다음 진행해주시기 바랍니다.   http://xibo.org.uk/  에 접속해서 아래 그림과 같이 표시된 것들을 다운로드 받습니다.  먼저 CMS를 설치해 보도록 하겠습니다. CMS CMS란?  CMS는 Content Management System의 약자로 말그대로 Digital Signage를 통해 보여줄 컨텐츠들을 관리하는 시스템이라 보시면 됩니다. CMS는 PHP/ MySQL 웹 어플리케이션 이며 Apache, nginx 그리고 Microsoft IIS에서 작동 합니다. CMS설치 다운로드 받은 CMS파일을 압축 푼 다음 C:\Bitnami\wampstack-5.5.31-0\apache2\htdocs에 다음과 같이 위치 시켜줍니다. Xibo폴더 내부는 다음과 같습니다. 그 다음 브라우저에 localhost/Xibo를 입력하면 다음과 같은 화면이 출력됩니다. 하지만 사진을 보시면 각 항목이 체크 표시가 된 경우도 있고 x표시가 된 경우도 있을 것 입니다. 그럴 경우 C:\Bitnami\wampstack-5.5.31-0\php 폴더에 있는 php.ini 파일을 열면  위와 같은 부분이 있을 것입니다. 저는 Fileinfo와 SOAP Extension에 문제가 있다고 되어있는데 이럴경우 저 부분에 extension=php_fileinfo.dll과 extension=php_soap.dll을 입력해주시면 해결이 됩니다.  나머지 설치를 진행해주시고 설치가 완료된 후에 로그인을 하면 ...
자세한 내용 보기