BeClaude

awesome-agent-conventions

New
17GitHub TrendingGeneralby ItamarZand88

A curated guide to convention files AI agents read, write, and act on: AGENTS.md, CLAUDE.md, SKILL.md, llms.txt, MCP configs, rules, and examples.

First seen 6/21/2026

Summary

txt, and MCP configs.

  • It helps developers understand how to structure these files for effective agent collaboration and automation.

Install & Usage

1
Create the agents directory
mkdir -p .claude/agents
2
Save the agent file

Add the configuration to .claude/agents/awesome-agent-conventions.md

3
Invoke with @agent-name
@awesome-agent-conventions

Use Cases

Set up AGENTS.md and CLAUDE.md files for a new project to define agent behavior and context.
Create a SKILL.md file to document a custom skill for reuse across projects.
Configure MCP settings and rules to enable tool access for an AI agent.
Review and optimize existing convention files to improve agent performance and clarity.
Generate an llms.txt file to guide large language models on project structure and conventions.
Learn best practices for writing agent-readable documentation from curated examples.

Usage Examples

1

/awesome-agent-conventions Show me how to create a CLAUDE.md file for a Python project.

2

I need to set up AGENTS.md and MCP configs for my new agent project. Use the awesome-agent-conventions skill.

3

List the key sections for a SKILL.md file based on the awesome-agent-conventions guide.

View source on GitHub
mcpagent

Security Audits

LicenseUnknownSourceWarnRepositoryPass

Frequently Asked Questions

What is awesome-agent-conventions?

This skill provides a curated guide to convention files that AI agents read, write, and act on, including AGENTS.md, CLAUDE.md, SKILL.md, llms.txt, and MCP configs. It helps developers understand how to structure these files for effective agent collaboration and automation.

How to install awesome-agent-conventions?

To install awesome-agent-conventions: create the agents directory (mkdir -p .claude/agents), then add the config to .claude/agents/awesome-agent-conventions.md. Finally, @awesome-agent-conventions in Claude Code.

What is awesome-agent-conventions best for?

awesome-agent-conventions is a agent categorized under General. It is designed for: mcp, agent. Created by ItamarZand88.

What can I use awesome-agent-conventions for?

awesome-agent-conventions is useful for: Set up AGENTS.md and CLAUDE.md files for a new project to define agent behavior and context.; Create a SKILL.md file to document a custom skill for reuse across projects.; Configure MCP settings and rules to enable tool access for an AI agent.; Review and optimize existing convention files to improve agent performance and clarity.; Generate an llms.txt file to guide large language models on project structure and conventions.; Learn best practices for writing agent-readable documentation from curated examples..