skill-creator

# Skill creator Create skills that trigger for the correct requests and improve agent results. ## Workflow 1. Read the conversation and the existing skill before asking questions. 2. Confirm the trigger, expected result, inputs, edge cases, and dependencies. 3. Write or revise the skill and any required resources. 4. Test realistic prompts in fresh BB threads. 5. Compare the results with the previous skill or no-skill baseline. 6. Revise until further changes do not give a useful improvement. Ask only for decisions that the available context cannot answer. Match the amount of evaluation to the risk and the result quality that the user needs. ## Skill contract A skill uses this structure: ```text skill-name/ ├── SKILL.md ├── references/ ├── scripts/ └── assets/ ``` Only `SKILL.md` is required. User skills live at `~/.bb/skills/<name>/SKILL.md`. The file starts with YAML frontmatter: ```yaml --- name: skill-name description: State what the skill does and when an agent must use it. --- ``` The directory and `name` value must match. A name uses lowercase letters, numbers, and single hyphens. It cannot exceed 64 characters. The description cannot exceed 1024 characters. Put all trigger conditions in the description. Include concrete tasks and nearby user phrases. Keep procedural instructions in the body. BB discovers edits for newly spawned threads. An existing thread does not receive a skill revision after it starts. ## Progressive disclosure BB loads skill informa...