Agents.md VS Skill.md

1. What they are

AGENTS.md contains rules the agent should follow during most tasks.

SKILL.md contains a workflow for one specific type of task.

2. Examples

Common AGENTS.md rules

• Use bun instead of npm.
• Run tests after changing code.
• Use the project’s configured formatter and linter.
• Follow the existing code style.
• Do not add lint or type-check suppressions.

Common SKILL.md workflows

• Creating and editing PDFs.
• Deploying a website.
• Testing an application in a browser.
• Reviewing code for security issues.
• Creating presentations or spreadsheets.

Simple rule: put regular project rules in AGENTS.md. Put task-specific workflows in SKILL.md.