atomicbot-ai/atomic-agent/skill-creator

skill-creator

Critical — invalid files are skipped at load

SKILL.md must start with the bytes --- then a newline, YAML mapping, closing --- line, then markdown body.

If the file starts with # Title or prose without that frontmatter block, the runtime drops the skill (parse error); it will not appear in ### skills.

Minimal valid template (copy and edit)

---
name: my-skill-name
description: One line when to load this skill and what it does (English ok).
version: 1.0.0
requires_tools: []
requires_scripts: []
dangerous: false
---
 
# my-skill-name
 
Body here. Use real tool names: `skill.view`, `os.http.request`, `browser.search`, …

Rules:

• name — kebab-case, same string as the parent folder (my-skill-name/SKILL.md → name: my-skill-name).
• description and version — required non-empty strings.
• requires_tools / requires_scripts — optional lists (documentation); omit empty keys if you prefer.

Where to write files

One folder per skill; single SKILL.md at folder root.

Workflow

1. Create folder + SKILL.md using the template above (frontmatter first).
2. Keep description short; put procedures in the body (visible only after skill.view).
3. Restart the agent / call refreshSkills so the registry rescans disk.
4. Verify with atomic-agent skill list (shows WARN: lines for broken dirs).

Do not

• Skip YAML — ever.
• Put secrets in the file or instruct bypassing approvals / HTTP allowlists.