@slinky-woochan/agent-skills

npx로 팀 에이전트 스킬 팩을 레포 루트에 펼쳐, Cursor와 Claude Code가 읽는 경로에 같은 내용을 둡니다.

| 툴 | 스킬 경로(프로젝트) | | ----------- | ----------------------------------------------------------------------------------- | | Cursor | .cursor/skills/<name>/ — Cursor가 로드(개인/내장 skills-cursor는 건드리지 않음) | | Claude Code | .claude/skills/<name>/ |

SKILL.md는 두 제품이 공통으로 쓰는 에이전트 스킬 포맷(frontmatter + 본문)에 맞췄습니다.

Claude 서브에이전트(.md)도 같이 받기

Claude Code 전용 서브에이전트(subagent) 정의는 agents/<name>.md 파일들로 번들에 포함되어, sync 시 <repo>/.claude/agents/<name>.md에 그대로 복사됩니다. (Cursor에는 동등 개념이 없어 Cursor 타깃에서는 자동 스킵)

| 툴 | 서브에이전트 경로(프로젝트) | | ----------- | ---------------------------------------------------------- | | Cursor | (없음) | | Claude Code | .claude/agents/<name>.md — Claude Code가 자동 로드 |

기본은 함께 복사되며, 필요 시 --no-agents-sync로 끌 수 있습니다.

사용

cd /path/to/your-repo
npx @slinky-woochan/agent-skills@latest init

• 기본 내장 pack/ 스킬을 .cursor/skills/, .claude/skills/에 복사(기본은 덮어씀). AGENTS.md는 기본으로 만들지 않는다.
• 팀 루트에 AGENTS.md 템플릿도 쓰려면 init에 --agents 를 붙인다(팀 루트: 모노레프면 루트 한 곳).

npx @slinky-woochan/agent-skills@latest init --agents

스킬만 (init과 동일하게 기본 pack·대화형 target, AGENTS.md 없음) 또는 sync만 쓰려면:

npx @slinky-woochan/agent-skills@latest sync

팀이 Git에 자체 팩을 두는 경우(예: tools/agent-pack/):

npx @slinky-woochan/agent-skills@latest sync -f ./tools/agent-pack
# `-C`는 하위 명령의 작업 루트(레포 밖에서 돌릴 때)
npx @slinky-woochan/agent-skills@latest -C /path/to/repo sync -f ./tools/agent-pack

서브에이전트(.md)도 자체 디렉터리에서 가져오려면:

npx @slinky-woochan/agent-skills@latest sync --agents-from ./tools/agents
# 스킬만 받고 서브에이전트는 빼고 싶으면
npx @slinky-woochan/agent-skills@latest sync --no-agents-sync

한쪽 에디터에만 쓰려면:

npx @slinky-woochan/agent-skills@latest sync -t claude
npx @slinky-woochan/agent-skills@latest sync -t cursor

info — 포함된 pack 절대 경로 확인:

npx @slinky-woochan/agent-skills@latest info

팀이 패키지를 퍼가는 방법

1. 소스 GitHub: dladncks1217/agent-skills. npm 패키지 이름은 @slinky-woochan/agent-skills (package.json의 name). 포크·사내용이면 name / repository를 팀에 맞게 바꾼다.
2. 기본 pack/ 대신, 팀 스킬은 별도 디렉터리로 두고 sync -f만 사용.
3. CI(선택): npx @slinky-woochan/agent-skills@latest sync -f ./pack -n으로 dry-run 검증.

npm에 publish (유지보수·@slinky-woochan)

• 퍼블리시하는 npm 계정이 **Organization slinky-woochan에 초대·권한(패키지 쓰기)**이 있어야 한다. (첫 publish는 조직에 연결된 계정/토큰으로.)
• package.json에 publishConfig.access: "public" 이 있어 스코프 패키지도 공개로 올라간다.
• GitHub Actions: 레포 Secrets에 NPM_TOKEN — (Classic) Automation 토큰 권장(2FA 계정의 CI publish). Granular는 publish·bypass 2FA 권한이 있는 토큰을 쓴다.
• 403 / 2FA 메시지가 나오면 토큰 종류를 **Automation(Classic)**으로 바꾸는 것을 우선 확인한다.

라이선스

MIT