AX 기초 — 스킬에 관하여

SemiClass · AX 기초

스킬에 관하여

AI에게 같은 설명을 세 번째 하고 있다면,
그건 적어둘 때입니다.

지난주엔 신입에게 책상을 줬습니다. 오늘은 그 신입에게 업무 매뉴얼을 줍니다.

시작 전 · 5분

세 가지만 확인하고 시작합니다

데스크톱 앱에서 바탕화면의 AI 폴더를 열어 주세요 Claude 의 Cowork·Claude Code, 또는 ChatGPT 의 Codex. 브라우저 화면은 파일을 못 읽습니다.
AI/skills/ 안에 폴더 몇 개가 보이면 준비 끝입니다 지난주에 만든 실습 도구들입니다. 오늘은 여기에 내가 만든 것을 하나 더 넣습니다.
지난주에 안 오셨어도 괜찮습니다 빈 폴더 하나만 있으면 따라오실 수 있습니다. 옆자리에 손 들어 주세요.

오늘 가져가실 것 — 내 반복 업무 하나가 스킬 하나로 바뀝니다. 다음 주부터 그 일은 "그거 해줘" 한마디로 끝납니다.

지난주 한 줄

신입에게 자리를 만들어 줬습니다

그 전

채팅창에 매번 붙여넣기

어제 대화는 오늘 못 찾음
같은 배경 설명을 매번 다시
어느 파일이 최신인지 모름

→

지난주 이후

바탕화면에 `AI/` 작업대

지식베이스/ — 계속 참인 사실
프로젝트/ — 끝이 있는 일
skills/ — 일하는 방법 ← 오늘

자리는 생겼습니다. 그런데 그 신입은 아직 일하는 법을 모릅니다.

왜 스킬인가

이번 주에 이 말을 몇 번 하셨나요

AI가 기억을 못 해서가 아닙니다. 그 설명이 아무 데도 적혀 있지 않기 때문입니다.

스킬이란

한 번 적어두고, 이름을 붙입니다

사람 신입에게는

업무 매뉴얼

이 일은 언제 하는가
어떤 순서로 하는가
무엇을 하면 안 되는가

한 번 써두면 다음 신입에게도 그대로 줍니다.

AI 신입에게는

스킬 (Skill)

이 일은 언제 하는가
어떤 순서로 하는가
무엇을 하면 안 되는가

한 번 써두면 다음 대화에서도 그대로 씁니다.

똑같습니다. 스킬은 새로운 기술이 아니라, 늘 쓰던 업무 매뉴얼을 AI가 읽을 자리에 둔 것입니다.

해부 · 1

폴더 하나, 마크다운 한 장

skills/
└── 주간보고-쓰기/
    ├── SKILL.md        본체. 이것만 있어도 동작합니다
    ├── references/     길어지면 여기로 덜어냅니다
    │   └── 예시모음.md
    ├── scripts/        38개 중 2개만 씁니다
    └── assets/         38개 중 2개만 씁니다

SKILL.md

--- name: 주간보고-쓰기 description: 이번 주 한 일을 주간보고 형식으로 정리할 때 사용한다. "주간보고", "이번 주 정리" 라고 하면 쓴다. ---

# 주간보고 쓰기 ## 순서 1. 이번 주 폴더에서 바뀐 것을 읽는다 2. 한 일 · 다음 주 할 일 · 막힌 것 세 갈래로 나눈다 3. 각 항목은 한 줄로 줄인다 ## 하지 않는 것 - 안 한 일을 채워 넣지 않는다

해부 · 2

맨 위 두 줄이 사실상 전부입니다

name

이 스킬을 뭐라고 부를까

폴더 이름과 같게 씁니다. 그게 전부입니다.

name: 주간보고-쓰기

헷갈리면 폴더 이름을 그대로 적으세요. 한글도 됩니다.

description

언제 이 스킬을 쓸까

AI는 이 줄만 보고 "지금이 그때인가"를 판단합니다.

description: … 할 때 사용한다

오늘 딱 하나만 기억하신다면 이겁니다. 뒤에서 다시 다룹니다.

나머지 본문은 사람이 읽는 문서와 똑같이 쓰시면 됩니다. 제목, 순서, 하지 말 것. 특별한 문법은 없습니다.

해부 · 3 · 못 믿으시겠으면

강사 컴퓨터에 깔린 스킬 38개를 세어봤습니다

2026-08-22 실측

36 ~~/ 36~~ 머리말이 name·description
둘뿐인 스킬 나머지 키는 예외 1건씩

117줄 SKILL.md 길이
중앙값 제일 짧은 건 20줄

2 ~~/ 38~~ 코드(scripts/)가
들어 있는 스킬 나머지 36개는 글만 있습니다

0줄 프로그래밍 언어를
써야 하는 부분 마크다운이 전부입니다

스킬은 프로그래밍이 아니라 글쓰기입니다. 그래서 오늘 여러분이 직접 만드실 수 있습니다.

믿기지 않으시면 직접 세어보셔도 됩니다 — 스킬 폴더의 SKILL.md 를 모아 맨 위 머리말만 훑으면 나오는 숫자입니다.

해부 · 4

왜 굳이 파일로 떼어놨을까요

전부 넣어두면

매번 다 읽어야 합니다

안 쓸 매뉴얼 30개를 책상에 다 펼쳐놓은 셈입니다. 자리도 없고, 정작 필요한 걸 못 찾습니다.

→

이름표만 보이면

필요할 때만 펼칩니다

평소엔 description 한 줄만 봅니다. "지금이 그때다" 싶을 때 그 파일을 펼쳐 읽습니다.

그래서 description을 대충 쓰면 그 스킬은 영영 안 쓰입니다. 잘 만들어 놓고 이름표를 안 붙인 것과 같습니다.

오늘의 2시간

둘러보고, 골라보고, 직접 만듭니다

0:00–0:10준비 · 지난주 잇기 작업대 열기 · 신입에게 매뉴얼을 준다는 이야기

0:10–0:48스킬이 무엇이고 왜 그렇게 생겼나 폴더 + SKILL.md + 머리말 두 줄 · 실측으로 확인

0:50–1:10실습 1 · 스킬 장터 둘러보기 남들이 만든 것을 열어 읽습니다. 설치는 안 합니다

1:10–1:25고르는 기준 · 어떻게 가져오나 폴더에 넣으면 끝 · description 잘 쓰는 법

1:25–1:50실습 2 · 내 스킬 만들기 내 반복 업무 하나 → SKILL.md 하나 → 실제로 발동 시험

1:50–2:00마무리 쌓이면 어떻게 되는지 · 다음에 할 것

실습 1 · 준비

남들이 이미 잔뜩 써놨습니다

가장 큰 곳

`skills.sh`

Vercel 팀이 운영합니다. Trending · Hot · Official 로 나뉘어 있어 뭐가 뜨는지 바로 보입니다.

Claude·Codex 등 20종 도구를 함께 지원합니다.

둘러보기 좋은 곳

`skillsclaude.org`

7,246개. 카테고리로 훑기 좋습니다 — 자동화 2,790 · 마케팅 632 · 생산성 616.

오늘 실습은 여기서 시작하시길 권합니다.

더 넓게

`claudemarketplaces.com`

23,600개 이상. 원하는 게 없을 때 마지막으로 뒤져볼 곳입니다.

많다고 좋은 건 아닙니다. 고르는 기준은 곧 말씀드립니다.

전부 그냥 웹사이트입니다. 회원가입 없이 열어서 읽으실 수 있습니다.

실습 1 · 준비

지금 사람들이 제일 많이 쓰는 것들

skills.sh · 2026-08-22 기준

스킬	무엇을 하는가	설치 수
`find-skills`	필요한 스킬을 대신 찾아 줍니다 — 스킬을 찾는 스킬	3,000,000
`grill-me`	AI가 대충 넘어가지 못하게 계속 캐묻게 만듭니다	927,600
`frontend-design`	화면을 만들 때 Anthropic 공식 디자인 기준을 따르게 합니다	802,500
`tdd`	코드보다 시험을 먼저 쓰게 만듭니다	735,200
`obsidian-vault`	옵시디언 노트를 [[링크]] 로 관리합니다 — 지난주 지식베이스와 같은 방식	—

1등이 "스킬을 찾아주는 스킬"이라는 게 이 세계를 잘 보여줍니다. 숫자는 오늘 기준이라 다음 주엔 달라집니다.

실습 1 · 20분

하나 골라서 열어보기만 합니다

설치하지 않습니다

skillsclaude.org 를 열고 내 일과 가까운 카테고리를 고릅니다 생산성 · 마케팅 · 자동화 · 분석. 직업이 아니라 지금 하는 일 기준으로 고르세요.
제목만 보고 "이건 나도 쓰겠다" 싶은 걸 하나 찾습니다 두세 개 눈에 들어와도 하나만 고릅니다. 다 보려다 아무것도 못 봅니다.
그 스킬의 SKILL.md 를 열어 끝까지 읽습니다 대부분 GitHub 링크가 붙어 있습니다. 길어야 한두 장입니다.
옆자리에 한 문장으로 말해 줍니다 — "이건 ○○할 때 쓰는 거래요" 그 한 문장이 바로 description 입니다. 다음 실습에서 직접 쓰실 겁니다.

읽으면서 확인 정말 마크다운 한 장이 맞나요? 프로그래밍 코드가 있나요? — 대부분 없습니다.

어떻게 가져오나

설치라고 부르지만, 사실 그냥 파일 옮기기입니다

오늘 우리 방식

폴더에 넣기

터미널 못 써도 됩니다 · 지난주 작업대가 있으면 끝

AI/skills/
└── 가져온-스킬/
    └── SKILL.md

여기 두면 AI가 알아서 읽습니다. 그게 전부입니다.

터미널 쓰시는 분

명령어 한 줄

개발 도구를 이미 쓰고 계신 경우

npx skills add <주인/저장소>

스킬 저장소는 GitHub 입니다. ~/.claude/skills 나 ~/.agents/skills 로 들어갑니다.

오늘은 왼쪽만 쓰시면 됩니다. 오른쪽은 "그런 것도 있다" 정도로 알아두세요.

만들기 전에 · 급소

여기서 대부분 실패합니다

이렇게 쓰면

description: 주간보고를 잘 써주는 스킬입니다

무엇인지만 적혀 있고 언제 쓰는지가 없습니다 → AI가 이 스킬을 영영 안 꺼냅니다.

이렇게 씁니다

description: 이번 주 한 일을 주간보고 형식으로 정리할 때 사용한다. "주간보고", "이번 주 정리", "팀장님 보고" 라고 하면 쓴다.

쓰는 상황 + 사람이 실제로 뱉는 말이 들어 있습니다 → AI가 알아채고 꺼냅니다.

공식은 하나입니다. 언제 쓰는지 + 내가 무슨 말을 할 때 쓰는지. 이 두 개만 넣으면 됩니다.

만들기 전에 · 규칙 셋

이 세 가지만 지키면 됩니다

하나

한 스킬에 한 가지 일

"보고서도 쓰고 메일도 쓰고 일정도 잡는" 스킬은 아무 때도 안 불립니다.

지식베이스에서 문서 하나에 개념 하나였던 것과 같습니다.

둘

하지 말 것을 적는다

"없는 숫자를 지어내지 않는다", "안 한 일을 채우지 않는다" 같은 줄이 품질을 만듭니다.

사람 매뉴얼도 금지사항이 제일 쓸모 있습니다.

셋

써보고 고친다

한 번에 완성되지 않습니다. 쓰다가 어긋난 부분을 그때그때 한 줄씩 고칩니다.

오늘 만드는 건 1버전입니다. 그거면 충분합니다.

길게 쓰려고 애쓰지 마세요. 아까 봤듯이 중앙값이 117줄이고, 짧은 건 20줄입니다.

실습 2 · 25분

내 반복 업무 하나를 스킬로 만듭니다

스킬로 스킬을 만듭니다

배부한 skill-builder 를 AI/skills/ 에 넣습니다 방금 배운 그 방법입니다 — 폴더째 옮기면 끝. 자료 탭에서 받으실 수 있습니다.
"내 스킬 만들어줘" 라고 요청합니다 AI가 한 번에 하나씩 물어봅니다. 어떤 일을 반복하는지부터 시작합니다.
질문에 답하다 보면 SKILL.md 가 만들어집니다 description은 AI가 초안을 주지만 직접 읽고 고치세요. 오늘 배운 급소입니다.
새 대화를 열어 실제로 불러봅니다 평소 하던 말투로 요청했을 때 그 스킬이 나오면 성공입니다. 안 나오면 description을 고칩니다.

주제가 안 떠오르시면 — 이번 주에 AI에게 두 번 이상 설명한 것, 매주 같은 형식으로 만드는 것, 남에게 알려주기 귀찮았던 것. 이 셋 중에 있습니다.

마무리 · 앞으로

하나씩 쌓이면 이렇게 됩니다

오늘

스킬 1개

그 일 하나는 "그거 해줘"로 끝납니다.

→

한 달 뒤

스킬 5~6개

자주 하는 일 대부분이 이름 하나로 불립니다.

→

그 다음

내 일하는 방식이 파일로

새 팀원에게 그대로 건네줄 수 있습니다. 도구를 바꿔도 남습니다.

지식베이스는 아는 것을, 스킬은 하는 법을 담습니다. 지난주와 이번 주가 그렇게 한 쌍입니다.

오늘 기억할 한 문장

같은 설명을 세 번째 하고 있다면

그건 적어둘 때입니다.

폴더 하나
마크다운 한 장
머리말 두 줄
언제 쓰는지를 적기

오늘 만든 스킬은 AI/skills/ 에 그대로 남습니다. 다음 주에 하나 더 만드시면 됩니다.