Agent Lore

What is an Agent Skill?

A skill is a reusable instruction file (SKILL.md) that AI agents discover and follow when a task matches the skill's trigger. It lives alongside your code and works across tools.

File structure

Place skills in one of these directories:

• ~/.claude/skills/ -- global skills for Claude Code
• ~/.cursor/skills/ -- global skills for Cursor
• .agents/skills/<name>/ -- repo-level skills (both tools)

Each skill folder contains one file:

.agents/skills/my-skill/
  SKILL.md

SKILL.md anatomy

# Skill Name

## Triggers
Use when the user asks to "do X", "build Y", or mentions "Z".

## Steps
1. First, check the existing code for ...
2. Then create/modify ...
3. Finally, verify ...

## Rules
- Always use TypeScript
- Never modify files outside src/

Tips

• Keep skills focused on a single task
• Include concrete examples in your steps
• Add file path patterns so the agent knows where to look
• Test by asking the agent to perform the trigger phrase