heydeer Sign in
Teach HeyDeer your codebase

Skills

Skills use the open Agent Skills format. A repository check lists the skills it needs, and HeyDeer uses them while it performs that check.

Where HeyDeer finds skills

Coding tools look for skills in different folders. HeyDeer uses the skills in .agents/skills/, as they are in the pull request, so a pull request can add or change the skills its own review uses.

  • Each skill is a folder with a SKILL.md. HeyDeer loads the whole folder the way the Agent Skills format describes, including files that SKILL.md refers to.
  • Skill names use lowercase letters, digits, and single hyphens, up to 64 characters.
  • Skills are guidance. If a listed skill is missing, HeyDeer still performs the check from its instructions.

List skills in a check

Add the skill names under skills in the check’s frontmatter:

---
paths: "src/routes/**"
skills: [api-auth]
---
Each new or changed route handler must run behind requireAuth.

Already using .claude/skills?

Add a symlink so the same skills are also in .agents/skills. You don’t need to move them:

mkdir -p .agents
ln -s ../.claude/skills .agents/skills
git add .agents/skills

See Claude Code’s skills documentation for how Claude Code finds skills.