@pulley-hub/skills

Pulley 코딩 에이전트 스킬 패키지입니다. 설치하면 Cursor, Codex, Claude Code 등 에이전트가 @pulley-hub/design-system 컴포넌트·토큰·아이콘으로 화면을 구현합니다.

설치

프로젝트 루트에서 에이전트에 맞게 실행합니다.

# Cursor
npx @pulley-hub/skills skill --agent cursor

# Codex
npx @pulley-hub/skills skill --agent codex

# Cursor + Codex
npx @pulley-hub/skills skill --agent cursor --agent codex

npx @pulley-hub/skills
npx @pulley-hub/skills add pulley-design-system

인자 없이 실행하면 Cursor와 .agents에 설치됩니다. Codex만 쓰려면 --agent codex를 붙입니다.

패키지를 설치한 뒤에는 bin 별칭으로도 같습니다.

pnpm add -g @pulley-hub/skills
pulley-design-system skill --agent codex

설치 위치 (프로젝트 스코프):

| 에이전트 | 경로 | | ----------- | ------------------------------------- | | Cursor | .cursor/skills/pulley-design-system | | Codex | .codex/skills/pulley-design-system | | Claude Code | .claude/skills/pulley-design-system | | 공용 | .agents/skills/pulley-design-system |

전역 설치(--global)는 같은 경로가 홈 디렉터리 아래로 갑니다. Codex는 ~/.codex/skills/pulley-design-system입니다.

옵션

# 전역 설치 (모든 프로젝트)
npx @pulley-hub/skills skill --global --agent cursor
npx @pulley-hub/skills skill --global --agent codex

# Cursor, Codex, Claude Code, .agents 전부
npx @pulley-hub/skills skill --agent all

# 특정 에이전트만
npx @pulley-hub/skills skill --agent cursor --agent codex
npx @pulley-hub/skills skill --agent cursor --agent claude

# 사용 가능한 스킬 목록
npx @pulley-hub/skills list

Claude 앱 (파일 업로드)

마켓플레이스 퍼블리싱 없이 Claude 데스크톱 앱에 넣을 때는 스킬 폴더를 zip으로 올립니다. zip 안에 .claude-plugin/plugin.json이 있어야 앱이 플러그인으로 인식합니다.

cd packages/pulley-skills/skills
zip -r pulley-design-system.zip pulley-design-system -x "*.DS_Store"

Claude 앱 → Customize → Personal plugins → Upload plugin에서 pulley-design-system.zip을 선택합니다. 확장자는 .zip이어야 합니다 (.plugin은 거절될 수 있음).

공식 skills CLI

npx skills add https://github.com/pulleymath/pulley-lxp/tree/main/packages/pulley-skills/skills/pulley-design-system

포함된 스킬

pulley-design-system

@pulley-hub/design-system을 1순위로 쓴다. 패키지가 없으면 설치하고, 쓸 컴포넌트의 타입과 구현을 읽은 다음 컴포넌트·색 토큰이 있을 때는 그걸 쓰며, 없을 때만 직접 구현한다.

에이전트에게 이렇게 요청하면 됩니다.

@pulley-hub/design-system을 우선 사용해 화면을 구현해.
패키지가 없으면 먼저 설치해.
node_modules에서 쓸 컴포넌트의 타입과 구현을 읽고, 있는 컴포넌트와 semantic 색 토큰을 쓰고, 없을 때만 직접 만들어.

컴포넌트 패키지(@pulley-hub/design-system)는 npm에 배포되어 있으며 앱에 따로 설치합니다.

npm install @pulley-hub/design-system

yarn add @pulley-hub/design-system

pnpm add @pulley-hub/design-system

로컬 개발

# 이 모노레포에서 현재 프로젝트에 스킬 설치
pnpm skills skill
# 또는
node packages/pulley-skills/bin/cli.mjs skill

배포

@pulley-hub/design-system과 같은 Changesets + release-design-system.yml로 배포합니다.

pnpm changeset

@pulley-hub/skills를 고르고 major / minor / patch를 남긴 뒤 main에 머지하면 버전 PR이 생기고, 그 PR을 머지하면 npm에 올라갑니다.

첫 배포 전에 npm 패키지 @pulley-hub/skills에 Trusted Publisher로 GitHub Actions 워크플로 release-design-system.yml을 등록해야 합니다. 디자인 시스템과 같은 워크플로입니다.