Menu

Not in the top 1,000 by GitHub stars

johnpapa/ai-ready

Agent Skill that analyzes your repo and generates the AI-ready configuration coding agents need — AGENTS.md, copilot-instructions, CI, issue templates, and more. Works in Claude Code, GitHub Copilot, Codex, and Cursor.

Claude CodeCodexCursorGitHub CopilotEngineering

History

Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.

View weekly changes

skills/ai-ready/SKILL.md

Week of Nov 2, 2026 · +0 / −0 lines

Before Instructions only → After Instructions only

c251292d2aaf → c251292d2aaf

Compare on GitHub

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Instructions only

First observation → c251292d2aaf

No earlier version was observed for comparison.

Compare on GitHub

View on GitHubAdd to my skills

Verified commit c251292d2aaf264cd21ac624a98dc34a8baa6150

git clone --filter=blob:none --no-checkout https://github.com/johnpapa/ai-ready.git .hotskills/johnpapa-ai-ready && git -C .hotskills/johnpapa-ai-ready checkout --detach c251292d2aaf264cd21ac624a98dc34a8baa6150 # Copy each selected skill directory from .hotskills/johnpapa-ai-ready into .claude/skills/<skill-name>/
git clone --filter=blob:none --no-checkout https://github.com/johnpapa/ai-ready.git .hotskills/johnpapa-ai-ready && git -C .hotskills/johnpapa-ai-ready checkout --detach c251292d2aaf264cd21ac624a98dc34a8baa6150 # Copy each selected skill directory from .hotskills/johnpapa-ai-ready into .agents/skills/<skill-name>/
git clone --filter=blob:none --no-checkout https://github.com/johnpapa/ai-ready.git .hotskills/johnpapa-ai-ready && git -C .hotskills/johnpapa-ai-ready checkout --detach c251292d2aaf264cd21ac624a98dc34a8baa6150 # Copy each selected skill directory from .hotskills/johnpapa-ai-ready into .cursor/skills/<skill-name>/
git clone --filter=blob:none --no-checkout https://github.com/johnpapa/ai-ready.git .hotskills/johnpapa-ai-ready && git -C .hotskills/johnpapa-ai-ready checkout --detach c251292d2aaf264cd21ac624a98dc34a8baa6150 # Copy each selected skill directory from .hotskills/johnpapa-ai-ready into .github/skills/<skill-name>/
237GitHub stars
2stars in 7 days
1skill in this repository
0commits in 30 days

Heat

2.4
  • Star growth, last 7 daysNot available
  • Star growth, last 24 hoursNot available
  • Rank movement, last 7 daysNot available
  • Commits, last 30 daysNot available
  • Accounts asking about it through MCP, last 7 daysNot available
  • Hot votes this weekNot available

Heat never changes the order by stars, and sponsorship never touches it. How heat works

Stars over time

Oct 25, 2026Nov 5, 2026237

30-day change not yet available: not enough history.

Individual skills in this repository

How it works

ai-ready

When your agent uses it

**ANALYSIS SKILL** — Analyze any repository and generate AI-ready configuration — a canonical AGENTS.md, thin per-tool pointer files, skills, CI workflows, issue templates. WHEN: "make this repo ai-ready", "set up AI config", "add copilot instructions", "prepare this repo for AI contributions", "generate AGENTS.md". INVOKES: glob, grep, view, create, edit for repo analysis and file generation. FOR SINGLE OPERATIONS: use create/edit directly for individual config files.

What it loads into context

Frontmatter

130 tokens

Always available to the agent

SKILL.md

5,156 tokens

When the skill is activated

Reference documents

13,166 tokens

Loaded on request

Token counts are estimates. Scripts run separately; they are not counted as reference context.

The playbook

  1. Persona
  2. Step 0 — Detect GitHub context automatically
  3. Step 1 — Analyze the codebase
  4. Step 2 — Generate AGENTS.md
  5. Step 3 — Generate per-tool pointer files
  6. Step 4b — Generate .mcp.json
  7. Step 4c — Generate reviewer agents
  8. Step 4d — Generate a starter skill from the maintenance matrix
  9. Step 4e — Generate a security skill, only if there is surface
  10. Step 5 — Generate CI workflow
  11. Step 6 — Generate issue templates and PR template
  12. Step 7 — Update README Contributing section
  13. Step 9 — Evaluate and improve changelog
  14. Step 10 — Evaluate and improve documentation
  15. Step 11 — Display the AI-Readiness Report
  16. Important Rules

Files

  • ../../.claude-plugin/marketplace.jsonasset934 bytes
  • ../../.claude-plugin/plugin.jsonasset505 bytes
  • ../../AGENTS.mddoc8,991 bytes
  • SKILL.mdcore21,869 bytes
  • data/risk-paths.ymlasset4,525 bytes
  • references/agents-md.mddoc6,371 bytes
  • references/detection-tables.mddoc16,413 bytes
  • references/github-discovery.mddoc5,116 bytes
  • references/report-template.mddoc10,782 bytes
  • references/reviewer-agents.mddoc6,995 bytes
Read SKILL.md

# AI-Ready Repo Skill

## Persona

Adopt the perspective of an experienced repo maintainer. Prioritize what **reduces review burden and contributor friction**. Every file you generate should earn its place — generic boilerplate creates noise.

---

Follow these steps in order to analyze the current repository and generate all missing AI-ready configuration assets.

**First run vs. re-run:** On the first run, most assets will be missing — the skill creates them. On re-runs, it **audits** existing assets against the current codebase, checking for drift, stale content, and new conventions from recent PR reviews.

**Skipping assets:** If the user's prompt mentions skipping specific assets, respect those exclusions. Still run the full analysis, but skip generation for the excluded assets.
View the complete source on GitHub

Skills included

  • ai-ready

Repository facts

License
MIT
Created
Apr 23, 2026
Last pushed
Sep 27, 2026
Forks
24
Open issues
1
Project activity
Active

Before you install

Instructions only

Automated signals, not a guarantee

Checked Nov 6, 2026

Show all 28 signals by file

.claude-plugin/marketplace.json

  • Network accessline 1
    {   "$schema": "https://json.schemastore.org/claude-code-marketplace.json",
  • Network accessline 2
    "$schema": "https://json.schemastore.org/claude-code-marketplace.json",
  • Network accessline 4
    "owner": {     "name": "John Papa",     "url": "https://github.com/johnpapa"
  • Network accessline 5
    "name": "John Papa",     "url": "https://github.com/johnpapa"   },
  • Network accessline 6
    "url": "https://github.com/johnpapa"
  • Network accessline 15
    "author": {         "name": "John Papa",         "url": "https://github.com/johnpapa"
  • Network accessline 16
    "name": "John Papa",         "url": "https://github.com/johnpapa"       },
  • Network accessline 17
    "url": "https://github.com/johnpapa"
  • Network accessline 18
    },       "homepage": "https://github.com/johnpapa/ai-ready",       "repository": "https://github.com/johnpapa/ai-ready",
  • Network accessline 19
    "homepage": "https://github.com/johnpapa/ai-ready",
  • Network accessline 20
    "repository": "https://github.com/johnpapa/ai-ready",

.claude-plugin/plugin.json

  • Network accessline 5
    "author": {     "name": "John Papa",     "url": "https://github.com/johnpapa"
  • Network accessline 6
    "name": "John Papa",     "url": "https://github.com/johnpapa"   },
  • Network accessline 7
    "url": "https://github.com/johnpapa"
  • Network accessline 8
    },   "homepage": "https://github.com/johnpapa/ai-ready",   "repository": "https://github.com/johnpapa/ai-ready",
  • Network accessline 9
    "homepage": "https://github.com/johnpapa/ai-ready",
  • Network accessline 10
    "repository": "https://github.com/johnpapa/ai-ready",

AGENTS.md

  • Network accessline 10
    The skill follows the vendor-neutral [Agent Skills](https://agentskills.io) standard, so one canonical
  • Network accessline 85
    - **Skills live in `skills/<name>/SKILL.md`** — markdown with YAML frontmatter (`name`, `description`) and steps - **The skill needs no code** — it uses the agent's built-in file tools. No extensions, no runtime - **Issue and PR text must s
  • Network accessline 86
    - **The skill needs no code** — it uses the agent's built-in file tools. No extensions, no runtime - **Issue and PR text must say it came from AI Ready** — e.g. `Assisted by [ai-ready](https://github.com/johnpapa/ai-ready)` - **Docs stay in
  • Network accessline 87
    - **Issue and PR text must say it came from AI Ready** — e.g. `Assisted by [ai-ready](https://github.com/johnpapa/ai-ready)`

skills/ai-ready/SKILL.md

  • Network accessline 399
    - **ALWAYS show the full report** — it's the user's view into what was found and changed. - **NEVER use markdown headings in user output** — use bold + emojis instead. - **ALWAYS mention the AI Ready skill in issue/PR communication** — when
  • Network accessline 400
    - **NEVER use markdown headings in user output** — use bold + emojis instead. - **ALWAYS mention the AI Ready skill in issue/PR communication** — when posting to an issue or PR (body or comment), include explicit attribution such as `Assist
  • Network accessline 401
    - **ALWAYS mention the AI Ready skill in issue/PR communication** — when posting to an issue or PR (body or comment), include explicit attribution such as `Assisted by [ai-ready](https://github.com/johnpapa/ai-ready)`.

skills/ai-ready/data/risk-paths.yml

  • Access to secretsline 128
    [Credential-related source omitted]

skills/ai-ready/references/detection-tables.md

  • Access to secretsline 154
    [Credential-related source omitted]

skills/ai-ready/references/report-template.md

  • Network accessline 179
    [![AI Ready](https://img.shields.io/badge/AI--Ready-yes-brightgreen?style=flat)](https://github.com/johnpapa/ai-ready)
  • Network accessline 218
    Assisted by [ai-ready](https://github.com/johnpapa/ai-ready)

How the signals fit together

Facts from a static read of the files at the pinned commit. They describe what the code does, not why.

Some files could not be read; the facts below still hold.

Signal confidence: 10 facts

Works with

Agent compatibility, from the files in this repository
AgentStatusEvidenceInstall to
Claude CodeNativeManifest .claude-plugin/marketplace.json.claude/skills/<skill-name>/
CodexNativeManifest AGENTS.md.agents/skills/<skill-name>/
CursorNativePath .cursorrules.cursor/skills/<skill-name>/
Gemini CLICompatibleStandard SKILL.md skills/ai-ready/SKILL.md.gemini/skills/<skill-name>/
GitHub CopilotNativeManifest .github/copilot-instructions.md.github/skills/<skill-name>/
OpenCodeCompatibleStandard SKILL.md skills/ai-ready/SKILL.md.opencode/skills/<skill-name>/
  • Native The repository ships a manifest, folder or frontmatter field for this agent.
  • Compatible A standard SKILL.md that this agent can read.
  • Unknown No evidence either way.

Derived automatically from paths, manifests and frontmatter. Not tested on each agent.

You might also use

open-gitagent/opengap

A framework-agnostic, git-native standard for defining AI agents

3kGitHub stars

mxyhi/ok-skills

Curated AI coding agent skills and AGENTS.md playbooks for Codex, Claude Code, Cursor, OpenClaw, and other SKILL.md-compatible tools.

510GitHub stars

microsoft/win-dev-skills

Agent plugins for building Windows apps with GitHub Copilot, Claude Code, OpenAI Codex, and more.

499GitHub stars

ronaknnathani/relay

Skills to orchestrate coding agents to do long horizon tasks with little to no steering

43GitHub stars

grimoire-rs/grimoire

Package manager for AI-agent config. grim installs, updates, and publishes skills, rules, agents, MCP servers, and bundles into Claude Code, Copilot, Cursor, Codex, Gemini, Zed, A…

15GitHub stars

docker/skills

A collection of Docker skills for AI coding agents to help them build, test, debug, and optimize containerized apps with consistent, reusable workflows.

617GitHub stars