Skip to main content
A skill is a Markdown playbook bundled with your agent. At runtime the agent can load the skill’s content into context to follow its instructions for a specific task.

​
Layout

Skills live under skills/<name>/ in your agent project. Each directory must contain a SKILL.md with YAML frontmatter declaring the skill’s name and description. 
skills/
  review/
    SKILL.md

---
name: review
description: Review a pull request using the team's checklist.
---

Steps to follow when reviewing a PR:
...

​
Declaring in dari.yml

List each skill under skills: with its name and repo-relative path (must be under skills/): 
skills:
  - name: review
    path: skills/review
  • name in dari.yml must match the name in SKILL.md frontmatter.
  • description is required in the frontmatter.
  • Duplicate names or paths fail publish.