feat(skills): 전체 플러그인·스킬을 npx skills로 설치 가능하게 하고 README 재구성 - #12
Merged
Conversation
- scripts/sync-skills-catalog.sh: plugins/*/skills/* 중 SESSION.md 등 공유 상태 없이 단독 설치해도 의미 있는 12개 스킬을 skills/<plugin>/<skill>/로 복사(npx skills가 심볼릭 링크를 안 따라가므로 실제 복사본으로 구성). domain-book-builder의 5개 내부 파이프라인 스킬은 의도적으로 제외. - fix(git-split-pr): SKILL.md description이 따옴표 없는 콜론+공백을 포함해 strict YAML 파싱이 깨지던 버그 수정(description: >- 블록 스칼라로 전환). 이 버그 때문에 npx skills add --list에서 조용히 누락되고 있었음. - README.md: 7개 플러그인 전부(기존 4개+누락 3개)와 13개 독립 스킬 전체를 설치법/사용법/목적 중심으로 재구성. 플러그인 설치(/plugin install)와 개별 스킬 설치(npx skills add --skill)의 차이를 표로 명시. npx skills add ureca-corp/claude --list로 13개 전부 정상 인식 확인, --skill로 콜론·공백·화살표 포함 이름 설치까지 실제 검증 완료.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
scripts/sync-skills-catalog.sh신설: 7개 플러그인 안에 있던 스킬 중 SESSION.md 같은 공유 상태 없이 단독 설치해도 의미 있는 12개를 최상위skills/<plugin>/<skill>/로 복사해npx skills가 스캔할 수 있게 노출. (npx skills는 심볼릭 링크를 따라가지 않는 것을 실측 확인해 실제 파일 복사 방식으로 구성)domain-book-builder의 5개 스킬(clarify, interview-domain, model-domain, design-api, write-book)은/domain-book-builder:start가 세션 상태를 넘겨가며 실행하는 5단계 파이프라인의 내부 스텝이라 의도적으로 제외 — 단독 설치로는 동작하지 않기 때문.project-starter도 커맨드 하나로만 구성돼 있어 독립 스킬 없음.plugins/git-split-pr/skills/git-split-pr/SKILL.md의description이 따옴표 없이 콜론+공백(사용: "diff...)을 포함해 strict YAML 파싱이 깨지고 있었음(mapping values are not allowed here).npx skills add --list에서 이 스킬이 조용히 빠지는 원인이었고,description: >-블록 스칼라로 전환해 해결.README.md전면 개편: 기존에 4개만 문서화돼 있던 플러그인 섹션을 7개 전부로 채우고(목적/설치/사용법/언제 쓰나), 독립 스킬 섹션도 1개(plan-build-verify)에서 13개 전체로 확장(요약 표 +<details>상세)./plugin install과npx skills add --skill의 차이를 표로 명시.실측 검증
skills/<name>) vs 2단계(skills/<category>/<name>) 카탈로그 레이아웃을 격리 테스트로 확인 — 심볼릭 링크는 인식 안 됨, 두 레이아웃 모두 실제 파일이면 인식됨.npx skills add ureca-corp/claude --list(로컬 fresh 경로 기준)로 13개 전부 정확히 인식되는지 확인.npx skills add ureca-corp/claude --skill "<이름>"으로 콜론 포함(python-fastapi-programmer:guard), 공백+화살표 포함(Implement Figma → Next.js 16 + shadcn/ui), 방금 고친git-split-pr세 가지 엣지 케이스를 실제 설치까지 검증, 파일 무결성(assets 포함) 확인.알려진 이슈(이번 PR 범위 밖, 별도로 트래킹)
marketplace.json이./plugins/gh-split-pr을 가리키지만 실제 디렉토리는git-split-pr—/plugin install gh-split-pr@ureca-plugins깨짐 가능성.plugins/project-docs-setup에.claude-plugin/plugin.json자체가 없음(./scripts/validate-all.sh로 로컬 확인) —/plugin install project-docs-setup@ureca-plugins깨짐 가능성.Test plan
./scripts/validate-all.sh— 이번에 건드린 부분은 통과(기존 project-docs-setup 이슈는 위 "알려진 이슈" 참고)npx skills add ureca-corp/claude --list13개 전부 인식npx skills add ureca-corp/claude --skill "<이름>"엣지 케이스 3종 실제 설치 검증https://github.com/ureca-corp/claude기준으로 재검증🤖 Generated with Claude Code