Contributing to agent-plugins
This repo is a plugin marketplace. Use the included CLI tool to install and manage skills.
CLI Tool
Run with dotnet scripts/plugin-cli.cs -- <command>.
Prerequisite: .NET 10 SDK (or later).
Commands
Each asset category (skills, agents, prompts, instructions, mcp, settings) supports:
| Subcommand | What it does |
|---|---|
list |
Show what's installed vs what's in the repo |
install |
Copy from repo → installed location |
uninstall |
Remove repo-managed assets from installed location |
diff |
Compare repo vs installed — shows missing, extra, and changed files |
Use all to operate across every category: all list, all install, all diff.
Common Workflows
# See what's out of sync
dotnet scripts/plugin-cli.cs -- skills diff --verbose
# Install a specific skill
dotnet scripts/plugin-cli.cs -- skills install --skill ci-analysis --force
# Install everything from the repo
dotnet scripts/plugin-cli.cs -- all install --force
# Dry-run to preview changes
dotnet scripts/plugin-cli.cs -- all install --dry-run
# Full sync: install repo assets AND remove extras not in repo
dotnet scripts/plugin-cli.cs -- all install --exact
Key Options
| Option | Effect |
|---|---|
--skill <name> |
Filter to one skill |
--plugin <name> |
Filter to one plugin group |
--scope personal|project |
Install to ~/.copilot/skills/ + ~/.claude/skills/ (default) or .github/skills/ |
--force |
Overwrite without prompting |
--exact |
Full sync — removes installed files not in repo (after backup) |
--dry-run |
Preview without changes |
--verbose |
Show detailed output |
💡 After editing a skill, run
skills install --skill <name> --forceto update your local copy.
Adding a Skill
Every new skill requires updates to 4 locations:
| Step | File | Action |
|---|---|---|
| 1 | plugins/<group>/skills/<name>/SKILL.md |
Create with name + description in YAML frontmatter |
| 2 | plugins/<group>/plugin.json |
Add path to "skills" array |
| 3 | .claude-plugin/marketplace.json |
Ensure plugin group is listed |
| 4 | README.md |
Verify skill appears in Available Plugins |