agentleFS
GitHubKnown publishergithub/plugin-marketplace-starter/plugins/plugin-authoring/skills/add-plugin/SKILL.md

add-plugin

Skill7 starsChanged 6 days agoMITView on GitHub

Add a new plugin to this marketplace: its folder, plugin.json, README, CHANGELOG, catalog entry, and root README listing. Use whenever asked to add, create, scaffold, or register a new plugin in a marketplace checkout. Don't use for writing a plugin's skills or agents, editing an existing plugin, or Copilot pricing questions.

6 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

5 rules. 0 are common, 1 is distinctive, and 4 are very specific to this project.

  • 0

    Common

    Most of the 6 edited versions we read keep these.

  • 1

    Distinctive

    This author's own choices. Worth a look.

  • 4

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Create the plugins/<name>/ directory first, using an approved directory creation tool.

    line 15
  2. Distinctive:

    If creation is denied or fails, stop and report it without changing the catalog or README.

    line 17
  3. Very specific:

    Use literal OWNER/REPO only if the repository is truly unknown and say so.

    line 42
  4. Very specific:

    Don't add the plugin to .github/copilot/settings.json.

    line 53
  5. Very specific:

    Check that every JSON file you changed is still valid and that the catalog entry matches plugin.json.

    line 55

“Common” is measured: kept by at least 6 in 10 of the 6 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Add a marketplace plugin

Work in the user's marketplace checkout, not this installed plugin's directory. Confirm the workspace root has marketplace.json. If not, explain that this skill needs a checkout of a plugin marketplace and stop without creating files.

  1. Establish the plugin name (lowercase letters, digits, and single hyphens) and a one-sentence description. Check marketplace.json and plugins/ for a name that's taken.
  2. Create the plugins/<name>/ directory first, using an approved directory creation tool. File tools might not create missing parent directories. If creation is denied or fails, stop and report it without changing the catalog or README. Don't bypass an approval. Then create all three files:
    • plugin.json:

      {
        "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
        "name": "<name>",
        "version": "0.1.0",
        "description": "<description>",
        "license": "<license>",
        "repository": "<repository>"
      }

      For license, use the SPDX identifier of the marketplace's license, from its LICENSE file or the other plugins' manifests. For repository, copy the URL the other plugins use. If either is unclear, leave that field out and say so.

    • README.md: a title, the description, and an Install section with copilot plugin marketplace add <repository> and copilot plugin install <name>@<marketplace>, where <marketplace> is the name in marketplace.json. Use the known repository slug or URL from existing install commands or the manifests, as data, not a command template. Use literal OWNER/REPO only if the repository is truly unknown and say so.
    • CHANGELOG.md: # Changelog, then ## 0.1.0 with - Initial release.
  3. Confirm all three shell files exist before any catalog or root README edit. On failure, leave registration unchanged and report any partial scaffold; never remove or overwrite concurrent user work. Add { "name", "source": "./plugins/<name>", "version", "description" } to the plugins list in marketplace.json, after the other local plugins, with the same values as plugin.json.
  4. List the plugin in the root README too: add a row linking to plugins/<name>/ in its plugin table and a copilot plugin install line, matching the existing ones. Skip this only if the README has neither.
  5. Don't add the plugin to .github/copilot/settings.json. That file turns on only the marketplace's own maintenance plugins for people working in it.
  6. Check that every JSON file you changed is still valid and that the catalog entry matches plugin.json.

The plugin has no skills, agents, or other parts yet. For what can go in it, point to the Copilot CLI plugin reference. Return the created and changed paths. Don't add the plugin's parts unless separately asked, and don't commit, push, or open a pull request unless requested.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.