anthod0/better-skills

better-skills은(는) 무엇을 하나요?

pnpm 스타일의 AI 에이전트 스킬 관리 CLI — 콘텐츠 주소 지정 저장소, 멀티 클라이언트 동기화, 프로필, 버전 관리

개요

better-skills는 AI 에이전트(Claude Code, Cursor, Codex 등)에서 사용하는 스킬을 효율적으로 관리하기 위한 도구입니다. pnpm의 패키지 관리 방식을 차용하여, 스킬을 콘텐츠 주소 지정(content-addressable) 방식으로 저장하고, 여러 클라이언트 간 동기화와 버전 관리를 지원합니다.

주요 기능

• pnpm 스타일 CLI: 친숙한 명령어 구조로 빠르게 적응 가능
• 콘텐츠 주소 지정 저장소: 동일한 내용의 스킬은 중복 저장하지 않음
• 멀티 클라이언트 동기화: 여러 AI 에이전트(Claude, Cursor, VS Code 등) 간 스킬 공유
• 프로필: 프로젝트나 사용자별로 스킬 설정 관리
• 버전 관리: 스킬의 변경 이력을 추적하고 특정 버전으로 롤백 가능

설치 방법

# npm을 통한 글로벌 설치
npm install -g better-skills

# 또는 yarn
 yarn global add better-skills

사용법

기본 명령어

# 스킬 추가
better-skills add <package-name>

# 스킬 제거
better-skills remove <package-name>

# 설치된 스킬 목록 확인
better-skills list

# 특정 클라이언트와 동기화
better-skills sync --client cursor

프로필 관리

# 프로필 생성
better-skills profile create my-awesome-setup

# 프로필 적용
better-skills profile use my-awesome-setup

# 프로필 내보내기
better-skills profile export my-awesome-setup > profile.json

버전 관리

# 스킬 버전 확인
better-skills version <package-name>

# 특정 버전 사용
better-skills use <package-name>@1.2.3

# 롤백
better-skills rollback <package-name>

환경 변수

변수명	설명	기본값
SKILLS_STORE_PATH	저장소 경로	~/.better-skills/store
SKILLS_CACHE_DIR	캐시 디렉토리	~/.better-skills/cache
SKILLS_SYNC_ENABLED	동기화 활성화 여부	true

스킬 구조 예시

스킬은 일반적으로 다음과 같은 디렉토리 구조를 가집니다:

my-skill/
├── SKILL.md          # 스킬 설명
├── index.js          # 진입점
├── package.json      # 메타데이터 (선택 사항)
└── prompts/         # 프롬프트 파일 (선택 사항)

지원 클라이언트

• Claude Code
• Cursor
• Codex CLI
• 기타 OpenAI 호환 API

라이선스

MIT