mirror of https://github.com/github/awesome-copilot.git synced 2026-02-20 10:25:13 +00:00

Files

Aaron Powell 9d1df57ebc refactor: migrate plugins to Claude Code spec format

- Move plugin manifests from .github/plugin/ to .claude-plugin/
- Convert items[] to Claude Code spec fields (agents, commands, skills)
- Rename tags to keywords, drop display/featured/instructions from plugins
- Delete all symlinks and materialized files from plugin directories
- Add eng/materialize-plugins.mjs to copy source files into plugin dirs at publish time
- Add .github/workflows/publish.yml for staged->main publishing
- Update CI triggers to target staged branch
- Update validation, creation, marketplace, and README generation scripts
- Update CONTRIBUTING.md and AGENTS.md documentation
- Include all new content from main (polyglot-test-agent, gem-browser-tester,
  fabric-lakehouse, fluentui-blazor, quasi-coder, transloadit-media-processing,
  make-repo-contribution hardening, website logo/gradient changes)

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

2026-02-18 14:22:50 +11:00

utils

feat(website): Add last updated dates for agents, prompts, instructions, and skills

2026-02-03 12:14:45 +11:00

add-missing-contributors.mjs

fix(contributors): address Copilot review comments and code quality issues

2026-01-15 08:54:51 -05:00

constants.mjs

Remove collections folder and migrate remaining references to plugins

2026-02-16 12:05:48 +11:00

contributor-report.mjs

Remove collections folder and migrate remaining references to plugins

2026-02-16 12:05:48 +11:00

create-plugin.mjs

refactor: migrate plugins to Claude Code spec format

2026-02-18 14:22:50 +11:00

create-skill.mjs

Final skills URLs

2025-12-18 09:53:16 -08:00

generate-marketplace.mjs

refactor: migrate plugins to Claude Code spec format

2026-02-18 14:22:50 +11:00

generate-website-data.mjs

refactor: migrate plugins to Claude Code spec format

2026-02-18 14:22:50 +11:00

materialize-plugins.mjs

refactor: migrate plugins to Claude Code spec format

2026-02-18 14:22:50 +11:00

README.md

Add documentation for marketplace.json generation

2026-02-13 01:51:52 +00:00

update-readme.mjs

refactor: migrate plugins to Claude Code spec format

2026-02-18 14:22:50 +11:00

validate-plugins.mjs

refactor: migrate plugins to Claude Code spec format

2026-02-18 14:22:50 +11:00

validate-skills.mjs

New awesome agent primitive

2025-12-17 15:27:05 -08:00

yaml-parser.mjs

Deprecate Collections in favour of Plugins

2026-02-13 15:38:37 +11:00

README.md

Contributor Reporting (Maintainers) 🚧

This directory contains build scripts and utilities for maintaining the repository.

Build Scripts

`update-readme.mjs`

Generates the main README.md and documentation files from the repository content (agents, prompts, instructions, skills, hooks, collections).

`generate-marketplace.mjs`

Automatically generates .github/plugin/marketplace.json from all plugin directories in the plugins/ folder. This file is used by the GitHub Copilot CLI to discover and install plugins from this repository.

How it works:

Scans all directories in plugins/
Reads each plugin's .github/plugin/plugin.json for metadata
Generates a consolidated marketplace.json with all available plugins
Runs automatically as part of npm run build

To run manually:

npm run plugin:generate-marketplace

`generate-website-data.mjs`

Generates JSON data files for the website from repository content.

Contributor Tools

contributor-report.mjs — generates a markdown report of merged PRs for missing contributors (includes shared helpers).
add-missing-contributors.mjs — on-demand maintainer script to automatically add missing contributors to .all-contributorsrc (infers contribution types from merged PR files, then runs the all-contributors CLI).

Key notes for maintainers

Reports are generated on-demand and output to reports/contributor-report.md for human review.
The report output is intentionally minimal: a single list of affected PRs and one command to add missing contributor(s).
This repository requires full git history for accurate analysis. In CI, set fetch-depth: 0.
Link: all-contributors CLI documentation

On-demand scripts (not CI)

These are maintainer utilities. They are intentionally on-demand only (but could be wired into CI later).

`add-missing-contributors.mjs`

Purpose: detect missing contributors, infer contribution types from their merged PR files, and run npx all-contributors add ... to update .all-contributorsrc.
Requirements:
- GitHub CLI (gh) available (used to query merged PRs).
- .all-contributorsrc exists.
- Auth token set to avoid the anonymous GitHub rate limits:
  - Set GITHUB_TOKEN (preferred), or GH_TOKEN for the gh CLI.
  - If you use PRIVATE_TOKEN locally, contributor-report.mjs will map it to GITHUB_TOKEN.

Graceful shutdown

contributor-report.mjs calls setupGracefulShutdown('script-name') from eng/utils/graceful-shutdown.mjs early in the file to attach signal/exception handlers.

Testing & maintenance

Helper functions have small, deterministic behavior and include JSDoc comments.
The getMissingContributors function in contributor-report.mjs is the single source of truth for detecting missing contributors from all-contributors check output.