use-skills는 설치된 스킬 중 어떤 것이 요청에 도움이 될지 선택하는 메타 스킬입니다.
use writing-plans, code-reviewer, testing, docs, and refactoring 같은 프롬프트를 작성하는 대신 $use-skills를 호출하여 적절한 조합을 추천하도록 합니다.
이 스킬은 기획과 코딩, 리뷰와 테스트, 작성과 구조, 문서화와 코드 변경 등 하나 이상의 영역에 걸친 요청이 있을 때 유용합니다.
한눈에 보기
- 모든 관련 스킬을 수동으로 언급할 필요가 없습니다.
- 사용 가능한 스킬 목록을 대신 검토합니다.
- 이전에 적용된 모드가 없을 때는 탐색 전에 사용자에게 모드 선택을 요청합니다.
- 각 모드별로 적합한 스킬 후보를 보여줍니다.
- 세 가지 모드를 지원합니다:
All related,Recommended,Restricted - 사용 시 짧은 작업 집합 블록으로 시작합니다.
- 선택된 지침을 하나의 일관된 결과로 결합합니다.
- 강력하게 일치하는 스킬이 없을 때는 사용되지 않습니다.
설치
npx skills add https://github.com/CyrusSE/use-skills --global
레지스트리 호환성
정식 런타임 스킬 파일은 skills/use-skills/SKILL.md에 있습니다.
이 skills/ 루트 구조는 skills.re와 같이 저장소 범위의 스킬 폴더를 기대하는 레지스트리와 호환되며, 일반적인 GitHub 설치 흐름도 그대로 유지합니다:
npx skills add https://github.com/CyrusSE/use-skills --global
기본 사용법
$use-skills
이 기능 요청을 테스트 노트가 포함된 구현 계획으로 바꿔줘.
이 요청이 기획, 리뷰, 테스트, 문서화 또는 다른 설치된 스킬을 포함해야 하는지 알 필요가 없습니다. use-skills가 선택 과정을 처리합니다.
요청이 명확히 여러 도메인에 걸쳐 있는 경우 스킬이 자동으로 선택될 수도 있습니다.
사용하는 이유
use-skills 없이 사용자는 스킬 카탈로그를 알고 올바른 조합을 수동으로 지정해야 합니다.
use-skills를 사용하면 워크플로우는 다음과 같습니다:
$use-skills
이 버그 리포트를 가장 관련성 높은 스킬 지침을 적용하여 패치해줘.
그런 다음 모드를 선택합니다. 에이전트가 프롬프트를 올바른 작업 집합에 매핑하고 작업을 계속합니다.
이는 특히 다음과 같은 경우에 유용합니다:
- 설치된 스킬이 많을 때
- 어떤 스킬 이름이 작업에 적합한지 확실하지 않을 때
- 작업이 동시에 여러 종류의 지침을 필요로 할 때
- 에이전트가 시작하기 전에 작업 집합을 설명하기를 원할 때
모드
이전에 적용된 모드가 없을 때, 스킬은 다른 작업을 하기 전에 먼저 질문합니다. 프롬프트는 사용자가 선택할 수 있도록 충분히 구체적이어야 합니다:
1. All related - 의미 있게 관련된 모든 사용 가능한 스킬을 사용합니다.
사용: use-skills, brainstorming, writing-plans, humanizer, enhance-prompt
용도: 수정 전략, 보고서 구조, 프롬프트 명확성, 문구에 대한 광범위한 적용
2. Recommended - 최상의 균형 잡힌 작업 집합을 사용합니다.
사용: use-skills, brainstorming, writing-plans
용도: 불필요한 노이즈 없이 강력한 결과물
3. Restricted - 가장 강력하게 일치하는 스킬만 사용합니다.
사용: use-skills, brainstorming
용도: 최소한의 스킬 개입으로 집중된 결과물
스킬 모드를 선택하세요. 1, 2, 3으로 답변하세요.
묻기 전에 파일을 검사하거나, 작업 공간을 검색하거나, 스킬을 선택하거나, 모드를 추론해서는 안 됩니다.
작업과 예상 출력이 실질적으로 변경되지 않았다면 다시 질문해서는 안 됩니다. best, most relevant, strongest 같은 단어는 명시적인 모드 선택으로 간주되지 않습니다.
터미널 참고: 모드 메뉴는 text 블록을 사용합니다. 일부 에이전트 CLI가 일반 목록 출력에서 빈 줄을 축소하기 때문입니다.
간격 규칙: 옵션 블록 사이에는 하나의 빈 줄이 있어야 합니다. 2. Recommended가 옵션 1의 For: 줄 바로 아래에 나타나면 메뉴 형식이 잘못된 것입니다.
All related
요청과 의미 있게 관련된 모든 사용 가능한 스킬을 사용합니다.
사용자가 명시적으로 광범위한 스킬 적용을 원할 때 가장 좋습니다.
Recommended
요청에 가장 적합한 균형 잡힌 작업 집합을 사용합니다.
일반적인 품질 향상을 위한 일반적인 선택입니다.
Restricted
가장 강력하게 일치하는 스킬(보통 1~3개)만 사용합니다.
사용자가 집중 또는 더 적은 스킬을 요청할 때 가장 좋습니다.
출력 형태
사용 시 응답은 다음으로 시작합니다:
Mode: All related | Recommended | RestrictedUsing: use-skills, <선택된 스킬>For: <짧은 목적>
그런 다음 에이전트가 답변, 계획, 패치 또는 권장 사항을 계속합니다.
모드 질문이 중요한 이유
모드 선택은 탐색 전에 의도적으로 질문합니다. 이렇게 하면 best, most relevant, strongest 같은 표현이 자동으로 가정된 모드로 전환되는 것을 방지합니다.
사용자는 명확한 선택을 할 수 있습니다:
1광범위한 적용2균형 잡힌 추천3집중 선택
적합한 경우
- 여러 스킬을 수동으로 나열하는 긴 프롬프트를 대체할 때
- 기능을 구현 전에 기획할 때
- 코딩, 테스트, 리뷰 지침을 결합할 때
- README 또는 제품 사양을 개선할 때
- 더 강력한 구조로 변경 사항을 검토할 때
- 집중된 답변을 위해 더 적은 스킬을 선택할 때
부적합한 경우
- 하나의 스킬로 충분한 좁은 작업
- 직접 명령만 필요한 요청
- 설치된 스킬이 명확한 가치를 더하지 않는 작업
문서 맵
agents/openai.yaml: 스킬 인터페이스 필드를 읽는 검색 표면을 위한 UI 메타데이터- skills/use-skills/SKILL.md: 런타임 동작
- REFERENCE.md: 선택 모델
- examples/prompts.md: 예제 프롬프트
저장소 구조
use-skills/
├── agents/
│ └── openai.yaml
├── assets/
│ └── use-skills-mode-picker.svg
├── examples/
│ └── prompts.md
├── skills/
│ └── use-skills/
│ └── SKILL.md
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── REFERENCE.md