AGENTS.md git:20261102.5fa75f4A

Immutable. This exact content never changes and is served at /api/v1/blob/f4737e20fe39ded2.

# AGENTS.md

This file provides context for AI coding agents working with this repository.

## What Is This Repo?

Awesome AI Agent Tools is an open-source library of installable AI agent components: skills, MCP servers, agent workflows, subagents, hooks, plugins, prompts, and tools curated from 100+ repositories.

## Repository Structure

| Directory | What It Contains |
|-----------|------------------|
| skills/ | SKILL.md files: reusable instruction sets that teach AI agents new capabilities |
| mcps/ | Model Context Protocol server configs with install commands |
| loops/ | Agent workflow patterns with verification criteria |
| subagents/ | Specialized agent definitions with model routing |
| hooks/ | Claude Code hooks for security, automation, and quality |
| plugins/ | Extensions for Claude Code, OpenCode, Cursor, and 6 more platforms |
| prompts/ | Curated prompt collections and marketplace links |
| tools/ | CLI utilities that enhance agent capabilities |
| mods/ | Claude Code mods: plugins that customize the Claude Code experience |

Exact per-category counts live in each `catalog.json` and in the generated `readme.md`. Do not hardcode counts in hand-written docs: they go stale. The generator reads the catalogs and emits the counts.

## Catalog Format

Each directory contains a `catalog.json` file with structured metadata:

```json
{
  "skills": [
    {
      "id": "skill-name",
      "name": "Display Name",
      "category": "Development",
      "description": "What this skill does",
      "githubUrl": "https://github.com/owner/repo",
      "installCommand": "npx skills add owner/repo --skill skill-name"
    }
  ]
}
```

Claude Code mod entries also require `source` (`owner/repo`), `installCommand`, `compatibility`, and `license`. Mods execute with Claude Code's available access; listing one does not mean it has passed a security audit.

## How to Contribute

1. Fork the repo
2. Add your entry to the correct catalog.json
3. Ensure JSON is valid: `cat skills/catalog.json | python3 -m json.tool`
4. Submit a PR

See [contributing.md](contributing.md) for full details. It is also the agent contribution skill: give it to your AI agent and it handles everything.

## Standards

- Skills follow the [SKILL.md open standard](https://agentskills.io)
- MCP servers follow the [Model Context Protocol](https://modelcontextprotocol.io)
- All entries are validated by GitHub Actions on PR

## Key Files

- `readme.md` - Main overview and catalog
- `SKILL.md` - Agent skill for installing from this collection
- `contributing.md` - Human and agent contribution guide
- `skills/catalog.json` - Machine-readable skills catalog
- `mcps/catalog.json` - Machine-readable MCP catalog
- `loops/catalog.json` - Machine-readable loops catalog
- `mods/catalog.json` - Machine-readable Claude Code mods catalog

Review policy: one human approval from someone other than the PR author, plus a passing catalog validation check. An approval should say “Go” and give one brief reason. The repository owner must configure this approval count in GitHub branch protection; documentation alone does not enforce it.

Claude Code mods are executable plugins and run with the user's Claude Code access. Require clear source attribution and available install, compatibility, and license details; do not describe listing as a security audit.