jjcm/bbcraft/submit-a-plugin

Submit a plugin

Submit a public plugin to the BB Community marketplace. The marketplace stores plugin metadata. The plugin code stays in its Git repository or npm package.

Choose the task

If the user asks only for instructions, explain the process without remote changes.

If the user asks for a submission, prepare and validate everything possible. Ask only for information that the plugin, Git, npm, GitHub, or marketplace cannot supply.

A submission request does not approve a release. Before the first Git push, tag, npm publication, or other release mutation, show the exact account, repository, commit, package, version, source, and commands. Get approval for that release.

Do not expose credentials, private URLs, or local secrets.

Read current contracts

The marketplace contract can change independently from BB releases. Read these files from the default branch of https://github.com/get-bb/marketplace:

• README.md
• schema/marketplace-v2.schema.json
• marketplace.base.json, for the current category IDs
• icons/README.md
• At least two current files in entries/

An entry file uses the version 2 entry fields. Read schema/marketplace-v2.schema.json for those fields. The older schema/marketplace.schema.json file describes the frozen version 1 output document. Do not use it as the entry contract.

Treat those files as the contract. Use this skill for workflow and quality rules.

Workflow

1. Read repository instructions, package.json, Git state, and release state.
2. Validate the plugin with its package manager and bb plugin build.
3. Select and verify one public release source.
4. Get separate approval before any release mutation.
5. Create one marketplace entry with a vendored icon.
6. Install the plugin and capture its screenshots.
7. Copy the plugin PLUGIN_OVERVIEW.md file into the marketplace. The public

marketplace requires an overview file on every entry.

1. Validate the marketplace repository.
2. Commit only the entry, icon, screenshots, and overview file.
3. Open a pull request from the submitter account.

Read these references as the task reaches each stage:

• Read references/plugin-release.md before validating or releasing a plugin.
• Read references/marketplace-entry.md before you create the entry, icon,

screenshots, or overview file. It states what a good entry and description hold, how to capture screenshots with a harness browser or computer automation tool, what to ask the user for when the harness has no such tool, which markdown the long-form description can use, and what to do when the plugin has no PLUGIN_OVERVIEW.md yet. It ends with a quality check to run before the pull request.

• Read references/pull-request.md before cloning, validating, or submitting

the marketplace repository.

Use scripts/derive-plugin-id.mjs to calculate the same plugin ID that BB uses:

node /PATH/TO/THIS/SKILL/scripts/derive-plugin-id.mjs /PATH/TO/PLUGIN/package.json

Completion

Return the pull request URL, released source, and validation results. Do not wait for a merge unless the user asks.

A compatible release within an existing tracking range usually needs no new marketplace pull request. Open another pull request when source, branding, description, long-form description, category, screenshots, ownership, tag, or range changes.