.agents-first best practices for AI agent skills — templates, guides, and auditing tools for Claude Code, Codex, Gemini CLI
This repository also configures its own agents. See what agents-best-practices tells them →
Skill Claude CodeCodex
Audit and improve existing agent skills against the agentskills.io specification and current best practices. Also audits CLAUDE.md, GEMINI.md, and AGENTS.md for bloat and configuration issues. Guides migration from client-specific folders to .agents/skills/ structure. Use when reviewing skill quality, checking…
Skill Claude Code
Creates new agent skills and iteratively improves existing ones following the .agents/skills/ specification. Guides through intent capture, SKILL.md writing, testing, and description optimization. Use when creating a skill from scratch, turning a workflow into a reusable skill, improving an existing skill's content or…
Skill Claude Code
Finds existing agent skills before creating a new one. Searches a curated list of 1184+ official skills from Anthropic, Vercel, Stripe, Supabase, Cloudflare, Sentry, MongoDB, Figma, and 40+ other teams. Use when the user asks "find me a skill for X", "is there an existing skill for Y", "how do I do Z", or expresses a…