Skills

A skill is a set of instructions that you write once and reuse in any chat. For example, a review-checklist skill can hold the steps your team follows before a pull request. You type /review-checklist in a chat, and the agent reads the skill and follows it. Skills work with every agent.

Where skills live

Each skill is a folder with a SKILL.md file in it. Wrangl looks in these places:

• Global skills are in ~/.agents/skills/ in your home folder. Every project can use them.
• Claude Code skills are in ~/.claude/skills/, and in the skills of the Claude Code plugins you have enabled. Wrangl lists them with your global skills, so a skill you already installed for Claude Code shows up without copying it.
• Project skills are in .agents/skills/ inside the project folder. Only that project can use them.

If two skills have the same name, the more specific one wins. A project skill beats ~/.agents/skills/, which beats ~/.claude/skills/, which beats a Claude Code plugin skill. Wrangl does not list skills from a Claude Code plugin that you turned off.

These are the same folders the Zed editor uses, so skills you wrote for Zed show up in Wrangl too.

Write a skill

1. Make a folder for the skill, for example .agents/skills/review-checklist/ in your project.
2. In that folder, make a file named SKILL.md.
3. Start the file with a name and a description, then write the instructions below them.

---
name: review-checklist
description: Review a diff against the Acme Shop checklist before you open a PR.
---

# Review checklist

1. Run `bun test`.
2. Check that every price uses cents, not floats.

The name can use only lowercase letters, digits and single hyphens, such as release-notes. Wrangl skips a skill with any other name. If you leave out name, Wrangl uses the folder name.

Write the description on one line. Wrangl does not read a description that spans several lines, such as one that starts with >-.

See your skills

Open Settings with Ctrl+, (Cmd+, on macOS) and click Skills. The page lists your Global skills and the skills of the project that is open. Click Open to edit a skill's SKILL.md in the editor.

Use a skill in a chat

1. In the chat box, type /.
2. Type part of the skill's name to filter the list. Skills are under Skills.
3. Pick the skill. It appears in your message.
4. Write the rest of your message and send it.

Wrangl tells the agent where the skill's SKILL.md file is, and the agent reads the instructions from there. You can use more than one skill in a message.