Skip to content

Project context and slash commands ​

AGENTS.md ​

Like other coding agents, the Agency agent will look for an AGENTS.md file in your project root, and read it if it exists.

Custom slash commands ​

The agency agent will also read any commands you have placed in .claude/commands/, and create a slash command that you can use in the agent. Slash command names follow the file name: a file named review.md becomes /review. Each command has a body and an optional description. The body is what gets run as a prompt by the agent if you execute that command. You can pass in arguments as well:

markdown
---
description: Review the staged diff for bugs
argument-hint: [focus area]
---

Review the currently staged git diff. Point out real bugs and risky changes.
Focus on: $ARGUMENTS

Now you can type /review error handling, and the agent will run the body, first replacing $ARGUMENTS with error handling.

Frontmatter options:

  • description — shown next to the command in the /help palette.
  • argument-hint — a hint about the arguments, shown after the description.

A file with no frontmatter still works, its command just has no description.