About Skills
Skills are reusable knowledge packages that extend the agent with domain-specific expertise — deployment guides, debugging playbooks, framework best practices, and more. Each skill is a self-contained skill folder with a markdown file that provides specialized instructions the agent can draw on during conversations. Skills follow the agentskills.io specification, ensuring compatibility across AI tools.Creating a Skill
Each skill lives in its own named directory containing a markdown file that shares the name of the directory:Markdown Format
Each markdown file must include YAML frontmatter with aname and description, followed by markdown content with instructions:
Frontmatter Fields
Skill Name Requirements
Skill names must:- Be 1–64 characters long
- Use only lowercase letters, numbers, and hyphens
- Not start or end with a hyphen
- Not contain consecutive hyphens
- Match the directory name containing the markdown file
python-testing, api-design, deploy-guide
Invalid names: Python-Testing, api_design, -deploy, my--skill
Skill Locations
Skills are discovered from multiple locations in order of precedence:
When multiple skills with the same name exist in different locations, the skill from the higher-precedence location is used.
Getting Started
1
Create a directory to host your skill
Navigate to Files > Organization > .augment > skills and create a new directory for your skill.
2
Create the my-skill.md file
Upload a markdown file to directory using the Upload File button:
3
Use the skill
The skill will be discovered automatically and injected into your Expert’s context.
Best Practices
- Focus each skill on a single domain — keep skills modular and specific
- Include concrete examples — provide code samples and commands
- Write clear descriptions — help the agent understand when to apply each skill
See Also
- agentskills.io Specification — Official skill format specification
- Understanding Files — the Files system where Skills are stored and managed
- Skills in Auggie CLI — Using skills with the CLI