git:20261006.0f90349 to git:20261102.5fa75f4

8 added, 0 removed. Audit A to A.

# 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.