Skip to content
niminal

Skills

Skills are directories that contain a SKILL.md file. niminal discovers them recursively and exposes them to the model through the skill tool and /skill:NAME slash commands. Supporting files can live beside SKILL.md.

Where skills live

Section titled “Where skills live”

Global skills (always loaded):

~/.agents/skills/<path>/<name>/SKILL.md
~/.niminal/skills/<name>/SKILL.md

Project skills (trusted workspace only; later roots win on name conflicts):

<workspace>/.agent/skills/<path>/<name>/SKILL.md
<workspace>/.agents/skills/<path>/<name>/SKILL.md
<workspace>/.niminal/skills/<path>/<name>/SKILL.md

Frontmatter

Section titled “Frontmatter”

Optional YAML frontmatter can declare a description:

---
description: Review pull requests for correctness and style.
---


Follow these steps when reviewing a PR...

Use name when the directory name is not the command name:

---
name: review
description: Review pull requests for correctness and style.
---

The description appears in slash suggestions and in the skill tool listing. When niminal loads a skill, it includes the skill directory so the model can resolve relative paths such as scripts/check.sh and references/rules.md.

Invoke a skill

Section titled “Invoke a skill”

In the TUI:

/skill:review focus on error handling

The model can also call the skill tool with {"name":"review"} when the task matches an available description.

Use /reload after adding or changing skills in a trusted project.

Next steps

Section titled “Next steps”