# Create A Skill

> Guided wizard that builds a custom Vodou skill from your description — picks a type, names it, writes SKILL.md + actions.json, registers triggers

- Skill: `vodouai/create-a-skill` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add vodouai/create-a-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vodouai/create-a-skill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: VodouAI (https://skillmd.com/u/vodouai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vodouai/create-a-skill

---

# create-a-skill

A guided wizard for building your own Vodou skill. Five quick questions, one new skill on disk + registered triggers + LLM-generated SKILL.md tailored to your description.

## How it works

1. **Describe** what your skill should do (free text)
2. **Pick a type:** plain workflow / system monitor / deep thinking / browser tools / custom
3. **Name it** (dashes only, e.g. `daily-health-check`)
4. **Confirm** → wizard:
   - Calls `_gateway::create_skill` with your inputs
   - LLM generates a SKILL.md tailored to your description (with fallback template)
   - LLM generates 3 trigger phrases for it
   - Writes the skill to `skills/my-skills/<name>/`
   - Inserts intent_mappings rows so the triggers route to the new skill
5. **Done** — say one of the trigger phrases to try it

## Where this works best

- **Main gateway chat (`localhost:8765`):** full wizard — text-input questions render and capture correctly via the workflow-driver
- **Skill panel:** menu options work; text-input questions (description, name) currently route through the LLM and won't reliably capture. Use main chat for the full wizard until skill-panel text-input support lands.

## After it runs

The new skill lands in `skills/my-skills/<name>/SKILL.md` + `actions.json`. You can:
- Edit the generated content directly
- Pull it back via `bt4 skill show <name>`
- Publish it to a private/personal catalog later

## Tip

Be specific in step 1 — "monitor my system every morning at 9am" produces better menu options than "check stuff".