Menu
Publish local skills to central repository for team sharing. Use when you've developed a useful pattern others should have.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
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