Create Agents Md

This creates AGENTS.md files for keeping project-specific instructions in your repo. Use it when you need small, inline rules like code style conventions, folder-scoped guidance in monorepos, or test-specific patterns that don't belong in a reusable skill. The structure is straightforward markdown without metadata, lives at your project root or in subdirectories where behavior diverges, and works best when you keep it short with concrete references to existing code examples rather than long explanations. The guide is clear about the boundaries: if it's reusable across projects or complex enough to need scripts, make it a skill instead.

skills.sh installs: 306
GitHub stars: 22
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add siviter-xyz/dot-agent --skill create-agents-md --agent claude-code

Installs into .claude/skills of the current project.

Files

Create AGENTS.md

Guide for creating AGENTS.md files for project-specific inline rules.

When to Use AGENTS.md

Small, project-specific instructions that should be committed in the repo
Folder-scoped rules for specific directories
Package-specific instructions in monorepos
Test-specific guidance in test directories

When NOT to Use AGENTS.md

Reusable knowledge across projects → Use skills
Large documentation → Use skills with references
Complex workflows → Use skills with scripts

AGENTS.md Structure

AGENTS.md is a simple markdown file without metadata:

# Project Instructions

## Code Style

- Use TypeScript for all new files
- Prefer functional components in React
- Use snake_case for database columns

## Architecture

- Follow the repository pattern
- Keep business logic in service layers