학습

Agent Skills 배우기

첫 Skill 설치부터 로드 실패 해결까지——Claude Code, Codex, Cursor용 짧고 쉬운 가이드.

첫 Skill 실행하기 에이전트 비교

계정 불필요주요 에이전트 지원검증된 패키지

플랫폼

어떤 에이전트를 사용하나요?

같은 SKILL.md 폴더는 에이전트 간에 이동할 수 있습니다——일상적으로 쓰는 런타임을 고르세요.

Claude Code

프로젝트 Skills & 슬래시 명령

Codex

터미널 네이티브 $skill-name

Cursor

Rules, Skills, Cloud Agents

세 가지 비교

폴더, 명령, 이름 규칙

여기서 시작

처음이신가요? 이 세 가지부터

Skill이란?

에이전트에게 한 종류의 작업(예: 슬라이드 제작)을 가르치는 지침 폴더로, 중심은 SKILL.md입니다.

예시 보기

시작하기

무료 Skill 하나를 설치하고 에이전트에서 실행해 결과를 확인한 뒤 커스터마이즈하세요.

Skill 실행하기

Skill 설치

Claude Code, Codex, Cursor가 찾을 수 있는 위치에 폴더를 두세요——개인/프로젝트 경로는 에이전트마다 다릅니다.

설치 가이드 보기

더 깊이

Skills를 더 잘 활용하기

Skills 사용법

Skill에 무엇을 주고, 생성 파일을 어떻게 확인하며, 더 나은 두 번째 초안을 얻는 방법.

Skills 트리거

에이전트가 특정 Skill을 고르는 이유와, 선택되기 쉬운 설명 작성법.

Skill 파일

SKILL.md, scripts/, references/를 이해하고, 폴더가 너무 깊으면 건너뛸 수 있습니다.

Skill 안전

설치 전 스크립트를 검토하고, 검증된 패키지를 선호하며, 신뢰할 수 없는 코드를 피하세요.

문제 해결

Skill이 안 되나요? 증상을 고르세요

/skills에 없음

폴더가 잘못되었거나 ZIP에 여분 계층이 있습니다. 경로는 <name>/SKILL.md로 끝나야 합니다.

자동으로 실행되지 않음

먼저 이름으로 호출한 뒤, 설명을 다듬어 에이전트가 요청을 인식하게 하세요.

다른 Skill이 실행됨

설명 중복 또는 이름 중복. 의도한 Skill의 첫 문장을 더 구체적으로.

로컬에서는 되고 클라우드에서는 안 됨

개인 폴더는 기기에만 있습니다. 프로젝트 Skills를 커밋하거나 Cursor Skills를 동기화하거나 claude.ai에서 활성화하세요.

비교

Skills와 MCP, 프롬프트, 규칙의 차이

작업에 맞는 추상화를 선택하세요——SkillsRadar가 발견과 조합을 돕습니다.

Skill

특정 결과를 위한 재사용 가능한 능력 패키지.

필요할 때 로드
에이전트 간 이식 가능
반복 작업에 최적

MCP

에이전트를 도구와 데이터 소스에 연결하는 프로토콜.

실시간 도구 접근
서버 기반
Skills를 보완

프롬프트

채팅에 붙여넣는 일회성 지시.

빠르게 시도
유지 보수 어려움
쉽게 변질

AGENTS.md / 규칙

매 실행 시작 시 로드되는 짧은 지침.

항상 컨텍스트에
짧게 유지
절차는 Skills로

도구 연결

하나의 계정, 모든 인터페이스

라이브러리에서 시작하고, 터미널이나 에이전트에서 이어가며, 맞춤 연동이 필요하면 API를 사용하세요.

CLI

터미널을 떠나지 않고 Skills 검색, 검사, 설치, 업데이트, 스캔.

로컬 워크플로에 적합

설치 가이드 보기

MCP

Cursor 또는 Claude Desktop을 연결해 채팅에서 Skills 검색·추천·설치 안내.

에이전트 내 탐색에 적합

MCP 설정 가이드

API & SDK

시맨틱 검색과 추천을 제품, 스크립트, 자동화에 가져오세요.

맞춤 연동에 적합

API 키 관리

유용

명령 치트시트

슬래시 명령, $ 호출, SkillsRadar CLI 설치.

/skills

Claude Code 또는 Codex에서 Skills 목록

/skill-name …

Claude Code 또는 Cursor에서 Skill 실행

$skill-name …

Codex에서 Skill 실행

npx @skillsradar/cli@latest install <slug>

기본 → ~/.agents/skills/ (Codex, Cursor 등)

npx @skillsradar/cli@latest install <slug> --agent claude-code

~/.claude/skills/에 설치

npx @skillsradar/cli@latest login

브라우저 로그인 → OS 키링

skillsradar-mcp

MCP stdio 서버 — Cursor 설정은 /learn/mcp

전체 에이전트 비교

위치

Skills가 있는 곳

에이전트마다 읽는 폴더가 다릅니다. 에이전트가 보는 곳에 두거나 SkillsRadar의 --agent 플래그에 맡기세요.

~/.agents/skills/공유 기본값 (Codex, Cursor, Gemini CLI 등)

~/.claude/skills/Claude Code (--agent claude-code 필요)

~/.gemini/config/skills/Antigravity

우선순위 보기

다음 단계

검증된 Skills를 탐색할 준비가 되셨나요?

라이브러리를 둘러보고, 에이전트로 필터하거나 Claude Code, Codex, Cursor 설치 가이드를 여세요.

Skills 탐색 Claude Code 가이드