AI Ready skill
A skill that analyzes a repository and generates files for AI agents: AGENTS.md, pointers, reviewers, CI and templates
- 238 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The skill creates files in the repository and offers to open a PR with the changes
- The generated CI and .mcp.json set which commands and services the agent sees
- The skill reads the repository's PR history and reviewer comments
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/ai-readyDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The skill creates files in the repository and offers to open a PR with the changes
- The generated CI and .mcp.json set which commands and services the agent sees
- The skill reads the repository's PR history and reviewer comments
This is third-party code. Review the repository files before installing.
What it does
AI Ready is an Agent Skills skill that analyzes a repository's code, CI, tests, docs and structure and creates project-tuned files agents need to contribute correctly. It is GitHub-native: it finds repository context, community health and PR review patterns on its own. It works with GitHub Copilot, Claude Code, Codex, Cursor and other clients of the standard. The main file is `AGENTS.md`: structure, build and test commands, architectural decisions, conventions mined from your PR reviews and a maintenance matrix. Three-line pointers `.github/copilot-instructions.md`, `CLAUDE.md` and `.cursorrules` lead to it. Also created are three reviewer agents for PRs, a starter skill from the maintenance matrix, a security review skill (when the repository has real surface), CI in `.github/workflows/ci.yml`, issue and PR templates, `CHANGELOG.md`, `.mcp.json`, a Contributing section and an AI-Ready badge. The skill only creates missing files, and on a re-run it audits existing ones against the code. The score is how many of 11 tracked assets are in good shape. If you want a report only, ask how AI-ready the repository is.
Who it is for. Maintainers of open source and team repositories on GitHub who are tired of repeating the same PR comments and want agents to know the project conventions.
Good fit when
- A repository has no AGENTS.md and agents send PRs with no tests that break the structure
- The same review comments get written in every PR and should become conventions
- Issue and PR templates, CI and reviewers are needed for one repository in one pass
- Before running the skill you want to assess readiness without creating files
- AI files are outdated and need checking against the current build and structure
Not a fit when
- The repository is not on GitHub: the skill relies on GitHub data and templates
- You need one narrow edit of AGENTS.md: the skill creates a whole set of files
- You do not want templates or CI: parts can be skipped with a phrase like skip CI and issue templates
Example request
Make this repository ai-ready but skip CI and issue templates, and show the report before creating filesLimitations
The skill is built for GitHub: it reads repository and PR practices from there. It only creates missing files and changes nothing without your agreement. At the Ready stage the skill can offer to open a PR with all the changes. In issue and PR messages it notes they were created by the AI Ready skill. The generated CI and `.mcp.json` reference your tools and databases, so read them before accepting. The last commit is from September 2026, and the current version is 1.4.0 as of the description.
How to disable. In Claude Code run /plugin uninstall ai-ready; for other tools remove the skills/ai-ready folder from ~/.agents/skills/ or use npx skills remove. Delete files the skill created in the repository separately.
FAQ
What does AI Ready create?
AGENTS.md, pointer files copilot-instructions.md, CLAUDE.md and .cursorrules, three reviewer agents, a starter skill, a security skill, CI, issue and PR templates, a changelog, .mcp.json, a Contributing section and a badge. Only what does not exist yet.
How do I invoke the skill?
With the phrase make this repo ai-ready. Explicitly: /ai-ready in Claude Code, Cursor and Copilot CLI, $ai-ready in Codex. As a Claude plugin the name is namespaced: /ai-ready:ai-ready.
How do I get only a report?
Ask how ai-ready the repository is or ask to score it: no files are created.
What if the agent does not use the skill?
Restart the agent, check the install with npx skills list, claude plugin list or similar, make sure both commands were run for Claude and Codex, and call the skill by name.
How do I update it?
npx skills update for the skills CLI, copilot plugin update ai-ready for Copilot, /plugin marketplace update johnpapa-ai-ready for Claude Code and codex plugin marketplace upgrade for Codex.
Discussion
No questions or reviews yet.
Related
SkillsA library of 30-plus instruction skills for coding agents: planning, building, testing, hallucination guards and shipping
Over twenty skills for coding agents: MCP and hooks, plan mode, a bug-fix protocol, prompting and a bash safety hook
Two skills for Codex and Claude Code: prd keeps a living implementation checklist and review audits designs from the user's side
A CLI that sets a project up for an agent in one command: skills, MCP and plan-driven development via /aif.
A skill that creates and updates AGENTS.md files per the agents.md spec: a thin root file plus separate files for each subsystem
The author's personal set: shared agent rules and dozens of skills for GitHub, the browser, macOS, messaging and releases, plus a sync script
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| AI Ready (this card) | no | 238 | |
| Rulesync | no | 1,600 | syncs rules across agents; AI Ready analyzes a repository and creates the files from scratch |
| AgentRules Architect | no | 124 | generates rules through project analysis; AI Ready adds templates, CI, reviewers and a score |
README in short
The description presents a skill that prepares a repository for AI agents. It continues with a quick start, install routes, usage, a report and a score over 11 assets, an explanation of the repeated review comments problem and a table of generated files.