짧은 답변
Skill 설치가 끝이 아닙니다. 에이전트가 Skill을 목록에 표시하고, 요청할 때 사용하고, Skill이 약속한 결과를 만들어 내면 완료입니다.
시작하기 전에 필요한 것
에이전트
Claude Code, Codex, Cursor 중 하나
Node.js 22+
Skillry CLI에만 필요하며, macOS와 Windows에서 실행됩니다
Skillry 계정
무료 Skill도 로그인이 필요합니다
세 에이전트 중 하나면 충분합니다. 이미 열어 둔 것을 사용하세요. 아래 단계는 에이전트마다 거의 다르지 않습니다.
어떤 Skill부터 써 볼까요?
1분 안에 결과를 판단할 수 있는 것을 고르세요. 이미지 Skill은 잘 작동했는지 한눈에 알 수 있어서 적합합니다. 아래 세 가지는 모두 무료입니다.
Notion Style OG Image
이미지. 런칭이나 게시물을 위한 16:9 Notion 스타일 공유 이미지.
Claude Style Illustration
이미지. 아이디어 하나를 에디토리얼 일러스트로 바꿉니다.
Scrapbook Resume Site
웹. 내 정보로 만드는 한 페이지 이력서 사이트.
설치하기 전에 Skill 페이지를 열고 이 Skill 소개 아래의 요구 사항을 읽어 보세요. Notion Style OG Image는 Node.js 20과 FAL API key가 필요하며, 이미지를 만들 때마다 유료 FAL 생성이 실행됩니다. Claude Style Illustration은 Node.js 20과 Python이 필요하고, 선택하면 유료 FAL 이미지 생성을 호출할 수 있습니다.
Skill 설치하기
- 1
Skillry에서 Skill을 열고 설치 프롬프트 복사를 선택하세요. 대화 상자에서 에이전트용 프롬프트를 복사하거나, 터미널로 설치로 전환해 명령어를 받을 수 있습니다.
- 2
터미널에서 사용하는 에이전트용 명령어를 실행하세요. Claude Code는
--agent claude-code가 필요하고, Codex와 Cursor는 필요 없습니다. 아직 로그인하지 않았다면 CLI가 로그인을 위해 브라우저를 엽니다.Claude Code npx --yes skillry-cli@latest install bs-notion-style-og --agent claude-code - 3
출력의 마지막 줄을 읽으세요. 버전과 Skill이 설치된 폴더가 나옵니다.
다음이 보여야 합니다:
Installed bs-notion-style-og <version> to ~/.claude/skills/bs-notion-style-og
터미널을 건너뛰고 싶다면 설치 프롬프트를 에이전트에 붙여 넣으세요. 이 방법과 ZIP 방법은 Skills 설치에서 다룹니다.
Skill 사용법: 두 번 실행해 보세요
한 번은 이름으로, 한 번은 평소 말로 실행하세요. 첫 실행은 Skill 자체를 테스트하므로 문제가 생기면 원인을 알 수 있습니다. 두 번째 실행은 description이 내가 실제로 요청하는 방식과 맞는지 보여 줍니다.
| Claude Code | Codex | Cursor | |
|---|---|---|---|
| 이름으로 | /bs-notion-style-og | $bs-notion-style-og | /bs-notion-style-og |
| 평소 말로 | “런칭 게시물용 OG 이미지 만들어 줘” | 동일 | 동일 |
Claude Code와 Codex는 이미 열려 있는 세션에서도 새 Skill을 인식합니다. Cursor는 시작할 때만 Skills를 찾으므로, Skill이 보이지 않으면 새 채팅을 열거나 창을 다시 불러오세요.
정말 작동했는지 어떻게 알 수 있나요?
설치 메시지가 아니라 결과물로 판단하세요. Skill이 로드되었는데 결과가 에이전트가 원래 만들었을 법한 것이라면, Skill이 제 역할을 하지 못한 것입니다.
이렇게 되면 완료입니다
- 에이전트가 Skill을 사용했다고 말하거나, Skill의 단계를 따르는 것이 보입니다.
- 결과물이 평범한 답이 아니라 Skill의 스타일이나 형식을 갖추고 있습니다.
- 약속한 파일이 프로젝트 폴더에 있습니다.
목록에 없음
폴더 위치가 잘못되었습니다. Skill 위치를 확인하세요.
목록에는 있지만 평소 말로는 트리거되지 않음
그런 Skill도 있습니다. 이름으로 호출하거나 트리거를 읽어 보세요.
시작했다가 멈춤
필요한 무언가가 빠져 있습니다. Skill 페이지를 확인한 다음 문제 해결을 보세요.
Skill 하나가 처음부터 끝까지 작동하면 다음 Skill은 1분 정도면 됩니다. 이후의 일상적인 사용법은 Skills 사용법에서 다룹니다.
자주 묻는 질문
Agent Skills를 쓰려면 코딩을 할 줄 알아야 하나요?
아니요. 설치 프롬프트가 설정을 처리하고, Skill은 이름을 입력하고 원하는 것을 설명하면 실행됩니다.
처음 써 보기 좋은 Skill은 무엇인가요?
Notion Style OG Image처럼 결과를 한눈에 판단할 수 있는 무료 Skill입니다. FAL API key가 필요하며, 이미지마다 유료 FAL 크레딧이 사용됩니다.
Skillry CLI는 Linux에서 작동하나요?
아직은 아닙니다. CLI는 로그인 정보를 macOS Keychain이나 Windows Credential Manager에 보관합니다. Linux에서는 설치 프롬프트나 ZIP 다운로드를 사용하세요.
출처
이 가이드가 도움이 되었나요?