Files
awesome-copilot/skills/ai-ready/SKILL.md
John Papa b171fc5743 Add ai-ready skill (wrapper) (#1551)
* Add ai-ready skill (wrapper)

Lightweight wrapper that installs the full ai-ready skill from
johnpapa/ai-ready and runs it. The full skill (~600 lines) analyzes
repos and generates AGENTS.md, copilot-instructions.md, CI workflows,
issue templates, and more — all customized to the repo's actual stack.

Wrapper approach keeps this repo's review surface small (30 lines)
while the source of truth stays in johnpapa/ai-ready.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* fix: use numbered steps to satisfy skill validator

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* fix: address Copilot review feedback

- Quote frontmatter description (YAML consistency)
- Add PowerShell install commands for cross-platform support
- Clarify that download overwrites existing copy
- Add note about pinning to a specific tag/commit
- Explicit invocation instructions (say 'make this repo ai-ready')

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: add ai-ready to skills index table

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* fix: correct ai-ready skill alphabetical order in README.skills.md

Run npm run build to fix the entry ordering that caused CI failure.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* fix: add review step before loading downloaded skill

Address code review feedback — users should inspect the downloaded
SKILL.md before reloading skills, per supply chain safety suggestion.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-04-30 10:05:47 +10:00

2.0 KiB

name, description
name description
ai-ready 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 SKILL.md by John Papa into their personal skills directory.

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 — always up to date.

Steps

  1. Tell the user to download the latest SKILL.md to their personal skills directory by running one of these commands in their terminal. This will overwrite any existing local copy.

    bash / zsh

    mkdir -p ~/.copilot/skills/ai-ready
    curl -fsSL https://raw.githubusercontent.com/johnpapa/ai-ready/main/skills/ai-ready/SKILL.md \
      -o ~/.copilot/skills/ai-ready/SKILL.md
    

    PowerShell

    New-Item -ItemType Directory -Force -Path "$HOME/.copilot/skills/ai-ready" | Out-Null
    Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/johnpapa/ai-ready/main/skills/ai-ready/SKILL.md" -OutFile "$HOME/.copilot/skills/ai-ready/SKILL.md"
    

    For reproducible behavior, the user can replace main in the URL with a specific tag or commit SHA.

  2. Suggest the user review the downloaded skill before loading it to confirm it contains expected instructions:

    head -20 ~/.copilot/skills/ai-ready/SKILL.md
    
  3. After the user confirms they've installed it, tell them to reload skills with /skills reload and then say make this repo ai-ready.

  4. Do not run the install command on the user's behalf. The user must run it themselves.