Cursor Skills: Cursor에서 Agent Skills 추가하고 사용하는 방법

짧은 답변

1모든 프로젝트에서 쓰려면 Skill을 ~/.cursor/skills/에 두세요(Cloud Agents에 동기화할 수 있는 유일한 폴더이기도 합니다). 프로젝트 하나에서만 쓰려면 .cursor/skills/에 두세요.
2SKILL.md의 name은 폴더 이름과 같아야 하며, 영문 소문자·숫자·하이픈만 사용할 수 있습니다.
3Customize → Skills에서 찾을 수 있습니다. /skill-name으로 실행하거나, @skill-name으로 메시지에 첨부하세요.
4바로 쓸 수 있는 Skill이 필요한가요? 명령어 하나로 설치할 수 있는 Cursor Skills를 둘러보세요.

Cursor가 Skills를 찾는 위치

Cursor는 자체 폴더, 공용 ~/.agents/skills/, 그리고 Claude Code와 Codex의 폴더까지 확인합니다. 이미 다른 에이전트를 쓰고 있다면 Skills가 이미 Cursor에 들어와 있을 수도 있습니다.

폴더	용도
`~/.cursor/skills/`	모든 프로젝트. Cloud Agents에 동기화되는 유일한 폴더입니다.
`~/.agents/skills/`	이 컴퓨터의 모든 프로젝트. Skillry가 여기에 설치하며, Codex도 이 폴더를 읽습니다.
`.cursor/skills/` 또는 `.agents/skills/`	프로젝트 하나, 저장소 어디든. 중첩된 폴더는 그 아래 파일에 적용됩니다.
`.claude/skills/`, `.codex/skills/` 및 `~` 아래의 같은 폴더	Claude Code와 Codex의 Skill도 여기서 작동하도록 읽습니다.

Cursor에 Skills를 추가하는 방법

Skillry CLI는 Cursor가 읽는 ~/.agents/skills/에 설치하므로 플래그가 필요 없습니다. 폴더를 직접 복사한다면 대신 ~/.cursor/skills/에 두세요. Cloud Agents까지 따라갈 수 있는 폴더입니다.

Cursor가 이미 열려 있다면 가장 쉬운 방법

1
Skillry에서 Skill을 열고 설치 프롬프트 복사를 선택한 다음, 대화 상자에서 복사를 선택하세요.
2
Cursor에 붙여 넣고 보내세요. 에이전트가 Skillry의 설치 안내를 읽고 알맞은 명령어를 직접 실행합니다.
설치 프롬프트
```
Read https://skillry.dev/skills/<slug>/install.md and follow the instructions to install the skill.
```
3
브라우저에서 기기 코드 승인을 요청하면 승인하세요.
다음이 보여야 합니다: Cursor에서 설치한 버전과 사용한 폴더(~/.agents/skills/ 아래)를 알려 주는 메시지.

명령어를 직접 실행하고 싶을 때 가장 좋음

1
한 번 로그인하세요. 브라우저 창이 열리고 승인할 기기 코드가 표시됩니다.
터미널
```
npx --yes skillry-cli@latest login
```
2
설치하세요. CLI의 기본 폴더가 Cursor에서 읽는 폴더이므로 플래그는 필요 없습니다.
터미널
```
npx --yes skillry-cli@latest install <slug>
```
다음이 보여야 합니다: Installed <slug> <version> to ~/.agents/skills/<slug>

Linux를 쓰거나 파일을 먼저 읽고 싶을 때 가장 좋음

Skill 페이지에서 ZIP 다운로드를 선택하거나, 다른 곳에서 받은 Skill 폴더를 사용하세요. 에이전트는 그 지침을 따르고 스크립트를 실행할 수 있으므로, 설치하기 전에 SKILL.md와 scripts/의 내용을 읽어 보세요. 그런 다음 폴더 전체를 옮기세요.

터미널

mkdir -p ~/.cursor/skills
mv ~/Downloads/my-skill ~/.cursor/skills/

ZIP을 풀면 my-skill/my-skill/SKILL.md처럼 폴더가 한 단계 더 생기는 경우가 많습니다. SKILL.md는 Skill 폴더 바로 안에 있어야 에이전트가 찾을 수 있습니다.

Cursor는 시작할 때 Skills를 찾습니다. 설치한 뒤 새 채팅을 열거나 창을 다시 불러온 다음, Customize → Skills의 Agent Decides 그룹에서 확인하세요.

Skill을 사라지게 만드는 이름 규칙

Cursor는 SKILL.md의 name이 Skill이 들어 있는 폴더 이름과 정확히 일치할 때만 Skill을 로드합니다. 다르더라도 오류는 나지 않습니다. Skill이 그냥 보이지 않을 뿐입니다.

왜 사라졌을까요?

launch-page를 내려받아 정리하려고 폴더 이름을 landing으로 바꿨더니 Cursor에서 사라졌습니다. 폴더와 name이 더 이상 일치하지 않기 때문입니다. 폴더 이름을 되돌리거나 name을 landing으로 바꾸세요.

Cursor가 받아들이는 이름

영문 소문자, 숫자, 하이픈만 사용
SKILL.md가 들어 있는 폴더 이름과 동일
description과 함께 있음

Cursor에서 Skill을 실행하는 방법

채팅에 /와 Skill 이름, 그리고 요청을 입력하세요.

Cursor 채팅

/launch-page Parcelo, a parcel-tracking dashboard for small online shops

세션 내내 Skill을 켜 두려면 / 메뉴에서 Skill을 고르고 Option+Enter(Mac) 또는 Alt+Enter(Windows)를 누르거나, Use as Mode를 선택하세요. Custom Mode로 바뀌어 종료할 때까지 켜져 있습니다.

Cloud Agents에서 Skills 사용하기

Cloud Agents는 내 컴퓨터에서 실행되지 않으므로 Cursor가 동기화해 준 Skills만 받습니다. 설정 방법은 다음과 같습니다.

1Skill을 ~/.cursor/skills/에 두세요. 프로젝트 Skill과 ~/.agents/skills/는 내 컴퓨터에만 남습니다.
2Settings → Agents → Context and Tools를 열고 Sync Skills for Cloud Agents를 켜세요.
3대신 개인 Skill을 팀과 공유하려면 Customize → Skills에서 Skill을 열고 Publish를 선택하세요.

Cursor 규칙 vs Skills

Cursor 규칙은 Cursor가 항상, 또는 일치하는 파일에 대해 대화에 추가하는 짧은 가이드입니다. Skill은 작업에 필요할 때만 에이전트가 로드하는 절차입니다. 컨벤션에는 규칙을, 여러 단계 작업에는 Skills를 사용하세요.

Skill

필요할 때 쓰는 절차

SKILL.md가 있는 폴더
관련 있을 때나 /name을 입력할 때 실행
여러 단계 작업, 스크립트, 템플릿

규칙

컨텍스트 속 가이드

.cursor/rules/의 .mdc 파일(일반 .md 파일은 무시됨)
Always Apply, Apply Intelligently, Apply to Specific Files, Apply Manually
짧은 컨벤션. Cursor는 AGENTS.md와 CLAUDE.md도 읽습니다

기존 규칙을 옮기고 싶나요? Cursor에 내장된 /migrate-to-skills가 “Apply Intelligently” 규칙과 슬래시 명령어를 Skills로 변환합니다.

Cursor Skill이 보이지 않나요? 이렇게 해 보세요

먼저 이름을 확인하세요. name과 폴더가 일치하지 않는 것이 Cursor에서 Skill이 사라지는 흔한 이유입니다.

Customize → Skills에 없음

name이 폴더와 일치하는지 확인한 다음, 새 채팅을 열거나 창을 다시 불러오세요.

Cloud Agents에서 보이지 않음

~/.cursor/skills/로 옮기고 동기화를 켜세요.

자동으로 선택되지 않음

description이 요청 방식과 맞지 않거나, paths가 다른 파일로 제한하고 있을 수 있습니다.

자주 묻는 질문

Cursor 규칙과 Skills는 어떻게 다른가요?

규칙은 Cursor가 항상, 또는 일치하는 파일에 대해 대화에 추가하는 가이드입니다. Skills는 절차를 담은 폴더로, 관련 있을 때나 호출할 때 에이전트가 사용합니다.

Cursor에서 Claude Skills를 쓸 수 있나요?

네. 각 Skill의 name이 폴더와 일치하기만 하면 Cursor는 ~/.claude/skills/와 .claude/skills/를 읽습니다.

Cursor Skills는 어디에 저장되나요?

모든 프로젝트용은 ~/.cursor/skills/ 또는 ~/.agents/skills/, 프로젝트 하나용은 .cursor/skills/ 또는 .agents/skills/입니다.

Cursor Cloud Agents에서 Skills가 작동하나요?

~/.cursor/skills/에 있는 Skill만, 그리고 Sync Skills for Cloud Agents를 켠 뒤에만 작동합니다.

출처

이 가이드가 도움이 되었나요?

이전OpenAI Codex 다음에이전트 비교

Cursor Skills: Cursor에서 Agent Skills 추가하고 사용하기