| name | skill-creator |
| description | Author or edit atomic-agent skills (SKILL.md + YAML). Use when creating, renaming, or tightening skills and their install layout. |
| version | 1.3.0 |
| requires_tools | ["os.fs.read","os.fs.write","os.fs.list"] |
| dangerous | false |
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
| Scope | Path |
|---|
| Global | <stateDir>/skills/<name>/SKILL.md (default ~/.atomic-agent/skills/) |
| Project | <workingDir>/.atomic-agent/skills/<name>/SKILL.md — overrides global on name clash |
One folder per skill; single SKILL.md at folder root.
Workflow
- Create folder +
SKILL.md using the template above (frontmatter first).
- Keep
description short; put procedures in the body (visible only after skill.view).
- Restart the agent / call
refreshSkills so the registry rescans disk.
- 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.