메뉴
Publish local skills to central repository for team sharing. Use when you've developed a useful pattern others should have.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Cross-project audit and sync. Backs up, bootstraps, promotes, syncs, and verifies all downstream projects.
Structured pre-planning research. Explores codebase, asks clarifying questions, and produces a brainstorm output file for /plan-feature input.
Capture knowledge from development sessions. Debug patterns, architecture decisions, framework gotchas, and integration learnings compound over time.
Load project context and show current status. Use at the start of a session or when context is needed.
Run parallel code reviews using specialized agents (security, performance, simplicity, nextjs-react). Produces a structured report.
Initialize a new project from Agent Kit boilerplate. Use when creating a new downstream project.
| name | publish-skill |
| description | Publish local skills to central repository for team sharing. Use when you've developed a useful pattern others should have. |
| disable-model-invocation | true |
| allowed-tools | Read, Write, Bash, AskUserQuestion |
| argument-hint | ["skill-name"] |
Share your locally developed skills with the team by publishing to the central repository.
/publish-skill [skill-name] # Publish specific skill
/publish-skill --list-local # List local skills not in central repo
/publish-skill [skill-name] --to [repo] # Publish to custom repository
Publish a skill when:
DO NOT publish:
/publish-skill --list-local
Output:
┌─────────────────────────────────────────────────────────────────────────────────┐
│ LOCAL SKILLS (not in central repo) │
├─────────────────────────────────────────────────────────────────────────────────┤
│ │
│ [1] pdf-analyzer Analyze PDF documents with AI │
│ [2] email-classifier Classify incoming emails by intent │
│ [3] meeting-notes Extract action items from meeting transcripts │
│ │
│ Already in central repo: │
│ - prime, session-end, commit, execute, linear, ... │
│ │
├─────────────────────────────────────────────────────────────────────────────────┤
│ Publish: /publish-skill [name] │
└─────────────────────────────────────────────────────────────────────────────────┘
/publish-skill pdf-analyzer
Validation Checklist:
┌─────────────────────────────────────────────────────────────────────────────────┐
│ PUBLISH SKILL: pdf-analyzer │
├─────────────────────────────────────────────────────────────────────────────────┤
│ │
│ PRE-PUBLISH CHECKLIST │
│ ───────────────────── │
│ │
│ [x] Has valid YAML frontmatter │
│ [x] Has name and description │
│ [x] Has usage examples │
│ [x] No hardcoded paths or credentials │
│ [x] No project-specific logic │
│ [ ] Has been tested │
│ │
│ ───────────────────────────────────────────────────────────────────────────── │
│ │
│ Confirm: Has this skill been tested? [Y/n] │
│ │
└─────────────────────────────────────────────────────────────────────────────────┘
After confirmation, the skill creates a PR:
# Fork/clone central repo if needed
# Create branch
git checkout -b skill/pdf-analyzer
# Copy skill
cp -r .claude/skills/pdf-analyzer ../agent-kit/.claude/skills/
# Commit and push
git add .
git commit -m "feat(skills): add pdf-analyzer skill"
git push origin skill/pdf-analyzer
# Create PR
gh pr create --title "feat(skills): add pdf-analyzer skill" \
--body "## New Skill: pdf-analyzer
### Description
Analyze PDF documents with AI
### Usage
\`\`\`
/pdf-analyzer [file.pdf]
\`\`\`
### Checklist
- [x] Tested locally
- [x] Generic (not project-specific)
- [x] Documented
"
Output:
┌─────────────────────────────────────────────────────────────────────────────────┐
│ SKILL PUBLISHED │
├─────────────────────────────────────────────────────────────────────────────────┤
│ │
│ Skill: pdf-analyzer │
│ Target: lucidlabs-hq/agent-kit │
│ Branch: skill/pdf-analyzer │
│ PR: https://github.com/lucidlabs-hq/agent-kit/pull/42 │
│ │
│ Status: Awaiting Review │
│ │
│ ───────────────────────────────────────────────────────────────────────────── │
│ │
│ Next Steps: │
│ 1. Team reviews the PR │
│ 2. After merge, skill is available via /clone-skill │
│ 3. All projects can now use it! │
│ │
└─────────────────────────────────────────────────────────────────────────────────┘
| Element | Description |
|---|---|
| Frontmatter | Valid YAML with name, description |
| Description | Clear explanation of what the skill does |
| Usage | Examples showing how to invoke |
| Process | Step-by-step instructions |
| Element | Description |
|---|---|
| Error Handling | Common errors and solutions |
| Examples | Multiple use case examples |
| Output | Sample output format |
| Related | Links to related skills |
| Element | Reason |
|---|---|
| Hardcoded paths | Won't work on other machines |
| API keys/secrets | Security risk |
| Customer names | Privacy |
| Project-specific logic | Not reusable |
/publish-skill crm-sync --to myorg/internal-skills
Useful for:
┌─────────────────────────────────────────────────────────────────────────────────┐
│ SKILL SHARING CYCLE │
├─────────────────────────────────────────────────────────────────────────────────┤
│ │
│ CENTRAL REPOSITORY │
│ lucidlabs-hq/agent-kit │
│ │ │
│ ┌───────────────┼───────────────┐ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │Project A│ │Project B│ │Project C│ │
│ └────┬────┘ └────┬────┘ └────┬────┘ │
│ │ │ │ │
│ │ Developer │ │
│ │ creates │ │
│ │ cool skill │ │
│ │ │ │ │
│ │ ▼ │ │
│ │ /publish-skill │ │
│ │ │ │ │
│ │ ▼ │ │
│ │ PR + Review │ │
│ │ │ │ │
│ │ ▼ │ │
│ │ Merged to Central │ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ /clone-skill Available! /clone-skill │
│ │
│ ───────────────────────────────────────────────────────────────────────────── │
│ │
│ RESULT: One developer's good idea benefits ALL projects! │
│ │
└─────────────────────────────────────────────────────────────────────────────────┘
| Error | Solution |
|---|---|
| "Skill not found" | Check skill exists in .claude/skills/ |
| "Already in central" | Skill already published, use /sync instead |
| "Auth failed" | Run gh auth login |
| "PR creation failed" | Check GitHub permissions |
# List local skills not yet published
/publish-skill --list-local
# Publish a skill
/publish-skill pdf-analyzer
# Publish to internal repo
/publish-skill secret-handler --to lucidlabs-hq/internal-skills
# Force republish (update existing)
/publish-skill linear --force
/clone-skill - Get skills from central repository/promote - Promote other patterns (not just skills)/sync - Sync all updates from upstream