skill official · GitHub

ai-ready — GitHub Copilot skill: what it does, how to install

Q: How to install ai-ready in GitHub Copilot?

Run `npx skills add github/awesome-copilot --skill ai-ready` in your terminal.

Analyzes your codebase and generates AGENTS.md, copilot-instructions.md, CI workflows, and issue templates customized to your stack.

Install into GitHub Copilot · Skills CLI (Vercel) All methods and platforms ↓

npx skills add github/awesome-copilot --skill ai-ready

Open on GitHub

What ai-ready does

This skill in github/awesome-copilot acts as a wrapper for the full johnpapa/ai-ready skill by John Papa. The complete implementation contains around 600 lines of instructions. It inspects your repository, extracts review patterns from pull requests, and creates AGENTS.md, copilot-instructions.md, CI workflows, and issue templates tailored to your technology stack.

The assistant cannot execute setup commands on your behalf, so you must enter them yourself. You add the core skill with /skills add johnpapa/ai-ready inside Copilot CLI, inspect the file with head -20 ~/.copilot/skills/ai-ready/SKILL.md, and reload the setup with /skills reload.

What it helps with

generate copilot-instructions.md tailored to the codebase
create AGENTS.md context files for AI agents
set up repository issue templates and CI workflows
extract review patterns from previous pull requests

Example prompts for the agent

make this repo ai-ready
set up AI config
prepare this repo for AI contributions

How to install ai-ready

1Skills CLI (Vercel)

npx skills add github/awesome-copilot --skill ai-ready

2GitHub CLI

gh skill install github/awesome-copilot ai-ready

3Manually: put the files in place

.github/skills/ai-ready/SKILL.md

1Skills CLI (Vercel)

npx skills add github/awesome-copilot --skill ai-ready -a claude-code

2Manually: put the files in place

~/.claude/skills/ai-ready/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/ai-ready/

Manually: put the files in place

.agents/skills/ai-ready/SKILL.md

For all projects use ~/.agents/skills/

Manually: put the files in place

.cursor/skills/ai-ready/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

Platform CLI

gemini skills install https://github.com/github/awesome-copilot --path skills/ai-ready

Manually: put the files in place

.devin/skills/ai-ready/SKILL.md

The legacy .windsurf/skills/ path still works

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about ai-ready

How to install ai-ready in GitHub Copilot?

Run npx skills add github/awesome-copilot --skill ai-ready in your terminal.

What does the ai-ready skill do?

It inspects your repository and PR review history to generate AGENTS.md, copilot-instructions.md, issue templates, and CI workflows.

Why does this skill reference johnpapa/ai-ready?

The skill serves as a discovery wrapper while the 600-line logic lives in johnpapa/ai-ready. This ensures you pull the most recent instructions directly from the source.

Source text

SKILL.md · MIT

---
name: ai-ready
description: 'Make any repo AI-ready — analyzes your codebase and generates AGENTS.md, copilot-instructions.md, CI workflows, issue templates, and more. Mines your PR review patterns and creates files customized to your stack. USE THIS SKILL when the user asks to "make this repo ai-ready", "set up AI config", or "prepare this repo for AI contributions".'
---

# AI Ready

This skill helps the user install the latest [ai-ready](https://github.com/johnpapa/ai-ready) skill by [John Papa](https://github.com/johnpapa).

*Why?*: The full ai-ready skill is ~600 lines of detailed instructions that evolve frequently. This wrapper keeps it discoverable here while the source of truth stays in [johnpapa/ai-ready](https://github.com/johnpapa/ai-ready) — always up to date.

## Steps

1. Tell the user to add the skill by running this command inside Copilot CLI:

   ```
   /skills add johnpapa/ai-ready
   ```

   This downloads the latest version of the skill to their personal skills directory. Re-running the command updates to the latest version.

2. Remind the user to review the skill before loading it. They can inspect it with:
   ```bash
   head -20 ~/.copilot/skills/ai-ready/SKILL.md
   ```
3. After the user confirms they've reviewed and installed it, tell them to reload skills with `/skills reload` and then say `make this repo ai-ready`.
4. Do **not** run the command on the user's behalf. The user must run it themselves.

here-be-git intellectronica Runs git init in the current folder, optionally adds agent commit rules to AGENTS.md, and writes a .gitignore. CX Codex +1 527installs scan Pranay Yadav Scans the codebase to generate project-doc.md and AGENTS.md. It sets up repository context for downstream agents and tracks architectural changes on subsequent runs. CX Codex 4,600installs Code Translator — Idiomatic, Version-Aware & Production-Ready sivasaiyadav8143 A prompt for translating code between languages. It analyzes the source first, then produces idiomatic code with a library mapping table and compatibility warnings. GP ChatGPT ★ 174,597repo stars bmad-project-context bmad-code-org Builds, audits, and maintains the verified agent instructions block inside AGENTS.md. It keeps repository rules accurate and records past agent mistakes as explicit pitfalls. CX Codex +1 11,500installs agents-md getsentry Generates and maintains concise AGENTS.md and CLAUDE.md instruction files for repositories. Keeps coding agent rules short, verified, and reference-backed. CX Codex +1 7,100installs sync jsmastery-pro A skill that brings AGENTS.md, the scope and spec status lines back in line with what the repo shows after a change. Runs in Claude Code, Codex, Cursor, Copilot, Gemini CLI and OpenCode. CX Codex +1 4,300installs

From the same set770

The whole set →

prompt-optimizer Converts rough drafts, tasks, and half-formed ideas into finished, copy-pasteable chat prompts without placeholder variables. 467installs commit-message-storyteller Parses git diffs or change descriptions to generate Conventional Commits messages that explain the intent behind code changes. 392installs ai-team-orchestration Bootstraps a lightweight multi-agent team inside your editor. It helps plan features, coordinate code changes, and preserve context across chat sessions. 381installs harness-engineering Turns repeated coding agent mistakes into repository rules, drift checks, and regression tests. Use it when Copilot keeps repeating the same errors in your project. 366installs linkedin-post-formatter Formats notes and technical drafts into LinkedIn posts with Unicode bold and italic typography. Ideal for drafting copy without markdown converters. 359installs md-to-docx Turns a Markdown file into a Word document with a title page, table of contents and embedded PNGs. Useful when a .md draft has to reach people as .docx. 353installs drawio Builds native .drawio diagram files and exports them to PNG, SVG, or PDF with embedded XML. 314installs Specification Generates and updates formal specification files for new or existing features. Works directly with your codebase to structure requirements and contracts. 298installs