AGENTS.md Generator

Generate production-quality AGENTS.md files for any public GitHub, GitLab, or Bitbucket repository — in seconds.

What is AGENTS.md?

AGENTS.md is the open standard for guiding AI coding agents. Stewarded by the Agentic AI Foundation under the Linux Foundation, it's already adopted by 60,000+ repositories and supported by OpenAI Codex, Cursor, GitHub Copilot, and Google Jules.

Think of it as a README for AI agents — it tells coding assistants how your project is structured, what conventions to follow, how to build and test, and what rules must never be broken.

What This Actor Does

1. Clones your public repository (depth=1, fast and lightweight)
2. Analyzes the entire codebase: structure, dependencies, tests, CI/CD, coding conventions, deployment config, and more
3. Generates a comprehensive, spec-compliant AGENTS.md using Claude AI
4. Supports monorepos — optionally generates per-package nested AGENTS.md files

Why Use This?

• Writing a good AGENTS.md by hand takes 30–60 minutes
• This generates one in 30 seconds
• AI coding agents work dramatically better with proper AGENTS.md files
• Your $5 is worth less than your time

Input

Field	Required	Description
repoUrl	✅	Public HTTPS URL (GitHub, GitLab, Bitbucket)
anthropicApiKey	✅	Your Anthropic API key (get one here)
branch		Specific branch (defaults to repo default)
includeNested		Generate per-package files for monorepos
customInstructions		Additional context to include
analysisDepth		"quick" or "standard" (default)

Output

• Dataset: Full results including generated content and analysis metadata
• Key-Value Store: Downloadable AGENTS.md file (and nested files for monorepos)

What Gets Analyzed

• 📁 File structure and project organization
• 🔧 Languages, frameworks, and dependencies
• 🧪 Testing setup (framework, commands, conventions)
• 🚀 CI/CD configuration
• 📦 Build scripts and deployment platform
• 🎨 Coding conventions (indentation, naming, imports, linters, formatters)
• 📝 Existing documentation (README, CONTRIBUTING, .cursorrules)
• 🌐 Environment variables and required tools
• 📦 Monorepo package detection

Pricing

$5 per generation (pay-per-event). Your Anthropic API key is used for Claude calls (typically $0.02–0.08 per generation with Sonnet).

Example

Input:

{
  "repoUrl": "https://github.com/vercel/next.js",
  "anthropicApiKey": "sk-ant-...",
  "analysisDepth": "standard"
}

Output: A complete AGENTS.md covering Next.js's architecture, monorepo structure, build system, testing conventions, and critical rules for contributors.

Privacy & Security

• Your repository is cloned temporarily and deleted immediately after analysis
• Your Anthropic API key is used only for this run and never stored or logged
• No code from your repository is stored after the Actor completes
• Analysis is read-only — no code execution from cloned repos

Support

Found a bug or have a feature request? Open an issue in the Issues tab.