lichens-innovation/create-skill

Create Skill

Scaffold a new skill directly inside the right plugin. The root skills/ folder is auto-generated by CI — do not create files there manually.

Workflow

1. Find repo root Run: git rev-parse --show-toplevel Store result as <repo-root>.

2. Gather info via script Run: node <skill-dir>/scripts/gather-skill-info.cjs The script prompts the user in the terminal and returns one JSON line: { name, description, triggers, plugin }

3. Create skill directory and SKILL.md Create <repo-root>/plugins/<plugin>/skills/<name>/SKILL.md with a minimal skeleton — do not impose a structure:

   ---
   name: <name>
   description: "<description>. Use when <triggers>."
   ---
   
   # <Title Case of name>
   
   Add instructions here. Structure freely: step-by-step workflow, reference tables, decision trees — whatever fits the skill.
   
   Optional subdirectories (create only if needed):
   - `scripts/`    — executable helpers (Node.js, Python, shell)
   - `references/` — supporting docs or templates
   - `assets/`     — static files (images, data)
   

4. Validate

   skills-ref validate <repo-root>/plugins/<plugin>/skills/<name>
   

   Fix any frontmatter or structure errors before proceeding.

5. Report to user

   • plugins/<plugin>/skills/<name>/SKILL.md created
   • The root skills/ folder will be updated automatically when changes are merged to main via the sync-skills GitHub Action
   • Next steps:
     • Fill in plugins/<plugin>/skills/<name>/SKILL.md with instructions
     • Add scripts/ or references/ dirs if the skill needs helper files
     • Alternative scaffold: npx skills init <name> (Vercel skills CLI)