| name | promote-skill |
| description | Promote a battle-tested user-level skill to the specflow shipped skills directory (specflow/skills/) |
Promote a skill from ~/.agents/skills/<name>/ to specflow/skills/<name>/.
Usage: /promote-skill <name> — e.g., /promote-skill my-workflow
Steps
-
Verify source exists
Read ~/.agents/skills/<name>/SKILL.md. If it doesn't exist, stop and report.
-
Sanitization check
Scan the skill content for lbruton-specific paths or personal preferences:
- Hardcoded paths like
/Volumes/DATA/GitHub/ that should be relative or omitted
- Personal workspace assumptions that won't work for other users
- Any
lbruton username references
Report findings and ask for confirmation if anything looks personal before proceeding.
-
Check for existing shipped copy
Check if specflow/skills/<name>/SKILL.md already exists.
If yes, show a diff of what would change.
-
Copy
mkdir -p /Volumes/DATA/GitHub/specflow/skills/<name>
cp ~/.agents/skills/<name>/SKILL.md /Volumes/DATA/GitHub/specflow/skills/<name>/SKILL.md
-
Verify diff
Run diff ~/.agents/skills/<name>/SKILL.md /Volumes/DATA/GitHub/specflow/skills/<name>/SKILL.md.
Only sanitization changes should appear. If other differences exist, flag them.
-
README check
Grep the README.md for the skill name. If not found, note that the skills inventory section needs updating and show the user the relevant README section to update manually.
-
Commit and open a PR
cd /Volumes/DATA/GitHub/specflow
git add skills/<name>/
git commit -m "feat(skills): promote <name> to shipped skills"
git push -u origin <branch>
Confirm completion with the commit hash and PR URL.