Skip to content

Add ai-ready external plugin#1542

Closed
johnpapa wants to merge 1 commit intogithub:stagedfrom
johnpapa:add-ai-ready-plugin
Closed

Add ai-ready external plugin#1542
johnpapa wants to merge 1 commit intogithub:stagedfrom
johnpapa:add-ai-ready-plugin

Conversation

@johnpapa
Copy link
Copy Markdown
Contributor

@johnpapa johnpapa commented Apr 28, 2026

What

Adds the ai-ready external plugin to the awesome-copilot marketplace — a Copilot CLI skill that analyzes any repository and generates AI-ready configuration assets.

What it does

When a user says "make this repo ai-ready", the skill:

  1. Auto-discovers GitHub context (zero user input) — repo metadata, language breakdown, community health, contributors, PR review patterns, CI workflows
  2. Mines PR review comments for repeated feedback → turns maintainer review fatigue into automated conventions in copilot-instructions.md
  3. Analyzes the codebase — manifest files, test setup, directory structure, existing AI config, changelog health, documentation setup
  4. Generates customized assets — AGENTS.md, copilot-instructions.md, copilot-setup-steps.yml, CI workflow, issue templates, README contributing section, maintenance matrix, and more
  5. Displays an AI-Readiness Report — score with progress bar, what was created/skipped/suggested
  6. Offers an opt-in AI-Ready badge — Shields.io badge for the README + ai-ready GitHub topic

Why

Contributors (human and AI) don't know a repo's conventions. Maintainers waste time re-teaching them in every PR review. AI agents compound this — more PRs, same quality gap. This plugin closes the gap by teaching AI how to work in the repo correctly.

Technical details

  • Skill-only — no extensions, no MCP servers, no arbitrary code execution
  • GitHub-native — uses GitHub MCP tools and gh CLI to auto-discover context
  • Uses only Copilot CLI's built-in tools (glob, grep, view, create, edit, bash)
  • Never overwrites existing files — only fills gaps
  • Self-consistency rule: generated files follow the conventions they establish

Tested on

Repo Type Result
DanWahlin/agent-arcade Tauri + Phaser game Generated 9 assets
johnpapa/vscode-peacock VS Code extension Generated 4 assets
johnpapa/shopathome Full-stack monorepo Generated 2 assets

Changes in this PR

File Change
.github/plugin/marketplace.json Added ai-ready entry (external, source.repo: johnpapa/ai-ready)
plugins/external.json Added ai-ready entry (matches existing external plugin format)

Plugin repo

https://github.com/johnpapa/ai-ready

Install (once merged)

copilot plugin install ai-ready@awesome-copilot

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings April 28, 2026 13:30
@johnpapa johnpapa requested a review from aaronpowell as a code owner April 28, 2026 13:30
@johnpapa
Copy link
Copy Markdown
Contributor Author

@aaronpowell - Tagging as per our chat

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds the external ai-ready plugin to this repo’s plugin registry so it appears in the generated Copilot CLI marketplace listing.

Changes:

  • Added ai-ready metadata to plugins/external.json (source of truth for external plugins).
  • Updated .github/plugin/marketplace.json to include the new external plugin entry.
Show a summary per file
File Description
plugins/external.json Registers the ai-ready external plugin (GitHub source + metadata).
.github/plugin/marketplace.json Marketplace listing updated to include ai-ready.

Copilot's findings

  • Files reviewed: 2/2 changed files
  • Comments generated: 0

@johnpapa
Copy link
Copy Markdown
Contributor Author

Closing in favor of a new approach — submitting as a lightweight wrapper skill instead of an external plugin. The wrapper installs the full skill from johnpapa/ai-ready, keeping the content in my repo while making it discoverable here. New PR incoming.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants