agent-readylisted

Best practices for setting up high-quality GitHub repos for AI coding agents. Use when setting up a new repo, improving an existing repo's infrastructure, or answering "what does this repo need for agents to work effectively". Triggers on "set up repo", "make repo agent-ready", "repo best practices", "/agent-ready".
agent-next/agent-ready · ★ 30 · AI & Automation · score 78

Install: claude install-skill agent-next/agent-ready

# Agent-Ready: Repo Setup Best Practices A curated collection of best practices for standard high-quality GitHub repos and AI coding agent workflows. Read this to learn what to set up — then use your own intelligence to generate project-specific configs. ## Workflow 1. **Analyze the project** — read package.json/pyproject.toml, understand language/framework/structure 2. **Check what's missing** — call `check_repo_readiness` MCP tool or run `npx agent-ready check .` 3. **Read the relevant reference** — for each missing area, read the reference doc below 4. **Generate project-specific configs** — use your understanding of THIS project, not generic templates 5. **Verify** — run linters, tests, check CI workflows are valid ## The 9 Areas | Area | Reference | What It Covers | |------|-----------|---------------| | Agent Guidance | `references/agent-guidance.md` | AGENTS.md, CLAUDE.md, copilot-instructions, cursor rules | | Code Quality | `references/code-quality.md` | Linters, formatters, type checkers, .editorconfig | | Testing | `references/testing/` | BDT methodology, test scaffolds, coverage (6 detailed refs) | | CI/CD | `references/ci-cd.md` | GitHub Actions: ci.yml, claude.yml, copilot-setup-steps.yml | | Hooks | `references/hooks.md` | Git pre-commit (Lefthook/Husky) + Claude PostToolUse hooks | | Branch Rulesets | `references/branch-rulesets.md` | GitHub rulesets via API (require PR, reviews, status checks) | | Repo Templates | `references/repo-templates.md` | Issue f