Add ai-ready skill (wrapper)

[johnpapa]

What this adds

A lightweight wrapper skill (~30 lines) that installs and runs the full ai-ready skill by John Papa.

How it works

When invoked, the wrapper:

1. Downloads the latest SKILL.md from johnpapa/ai-ready to ~/.copilot/skills/ai-ready/
2. Reloads skills
3. Runs the full analysis on the current repo

Why a wrapper?

The full ai-ready skill is ~600 lines and evolves frequently. Rather than maintaining a copy here that goes stale, this wrapper keeps the skill discoverable in awesome-copilot while the source of truth stays in johnpapa/ai-ready — always up to date.

• Small review surface — 30 lines for this repo to review and maintain
• Always current — curl pulls the latest version on every install
• No external plugin policy concerns — it's a skill, not an external plugin
• One-time install — once downloaded, it works across all repos

What the full skill does

Analyzes any repo and generates:

• AGENTS.md — repo structure, build/test commands, how to add features
• .github/copilot-instructions.md — conventions mined from PR reviews + maintenance matrix
• .github/copilot-setup-steps.yml — cloud agent setup
• CI workflow, issue templates, PR template, changelog, and more

Scores repos on a 🥉→🏆 medal system (12 tracked assets across AI Context, Dev Workflow, and Onboarding categories).

Previous PR

Replaces #1542 (external plugin approach), closed in favor of this wrapper approach per feedback about external plugin policy.

[github-actions]

🔍 Skill Validator Results

✅ All checks passed

Scope	Checked
Skills	1
Agents	1
Total	2
Severity	Count
---	---:
❌ Errors	0
⚠️ Warnings	0
ℹ️ Advisories	0

Summary

Level	Finding
ℹ️	Found 1 skill(s)
ℹ️	[ai-ready] 📊 ai-ready: 521 BPE tokens [chars/4: 516] (detailed ✓), 2 sections, 3 code blocks
ℹ️	✅ All checks passed (1 skill(s))

Full validator output

```text Found 1 skill(s) [ai-ready] 📊 ai-ready: 521 BPE tokens [chars/4: 516] (detailed ✓), 2 sections, 3 code blocks ✅ All checks passed (1 skill(s)) ```

[Copilot]

Pull request overview

Adds a new wrapper skill that makes the upstream johnpapa/ai-ready skill discoverable in this repo while delegating the full (rapidly evolving) implementation to the upstream project.

Changes:

• Added skills/ai-ready/SKILL.md containing wrapper instructions to download the latest upstream SKILL.md into ~/.copilot/skills/ai-ready/.
• Included steps to reload skills and then run the installed ai-ready skill on the current repository.

Show a summary per file

File	Description
skills/ai-ready/SKILL.md	New wrapper skill that installs the upstream ai-ready skill definition and guides users to reload and run it

Copilot's findings

Comments suppressed due to low confidence (1)

skills/ai-ready/SKILL.md:32

• After /skills reload, the instructions say “Then run the ai-ready skill…” but don’t specify how to invoke it. The CLI docs indicate skills can be invoked directly as a slash command (e.g., /ai-ready) or by asking with a matching prompt; adding an explicit invocation step here would reduce user confusion.

• Files reviewed: 1/1 changed files
• Comments generated: 5

[aaronpowell]

We've got a CI failure - the entry in the README is in the wrong place, running npm run build will correct that.

[johnpapa]

We've got a CI failure - the entry in the README is in the wrong place, running npm run build will correct that.

Thanks, I addressed it.

[johnpapa]

Addressed all 5 Copilot code review comments on PR.

1. Description quoting — already fixed (single quotes)
2. README.skills.md entry — already fixed (npm run build)
3. Single file download clarity — already fixed (says "download the latest SKILL.md")
4. PowerShell equivalents — already included
5. Review step before loading — added head -20 review step so users inspect the downloaded skill
   before reloading