elevate-skill

When to invoke

• User wants to share a project-local skill with other repos
• User says "elevate skill", "share this skill", "move skill to ai-skills"

Steps

1. Discover local skills: List directories in .claude/skills/ whose name is NOT a key in skills-lock.json (if it exists). These are locally-authored project skills.

2. Ask which skill to elevate: Present the list and let the user choose.

3. Find ai-skills repo: Use $AI_SKILLS_REPO if set, else try ~/projects/camacho/ai-skills, else ask the user.

4. Copy to ai-skills:

   cp -r .claude/skills/<name> <ai-skills-path>/skills/<name>
   

   Verify the SKILL.md has correct frontmatter (name matches folder name).

5. Commit + push in ai-skills:

   cd <ai-skills-path>
   git add skills/<name>
   git commit -m "feat: add <name> skill"
   git push
   

6. Remove local copy and install from repo:

   rm -rf .claude/skills/<name>
   npx skills add <ai-skills-path> --skill <name> -a claude-code -y
   

7. Commit in current project:

   git add skills-lock.json .claude/skills/
   git commit -m "chore: elevate <name> skill to ai-skills"
   

Discovery logic

# Local skills = dirs in .claude/skills/ NOT tracked by lockfile
if [ -f skills-lock.json ]; then
  LOCKED=$(python3 -c "import json; print(' '.join(json.load(open('skills-lock.json'))['skills'].keys()))")
fi
for dir in .claude/skills/*/; do
  name=$(basename "$dir")
  if ! echo "$LOCKED" | grep -qw "$name"; then
    echo "$name (local)"
  fi
done