`create-plugin-scaffold` documents unsupported `marketplace.json` metadata fields
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 8.2k
- Forks
- 751
- Avg merge
- 12h 1m
- Merged PRs (30d)
- 43
Description
Description
The create-plugin-scaffold skill instructs users to add keywords, category and tags as optional metadata on entries in .cursor-plugin/marketplace.json:
6. If repository uses `.cursor-plugin/marketplace.json`, add plugin entry:
- `name`
- `source`
- optional metadata (`description`, `keywords`, `category`, `tags`)
This conflicts with the marketplace schema. A marketplace plugin entry has additionalProperties: false and permits only:
namesourcedescriptionminClientVersions
The keywords, category and tags fields are supported by .cursor-plugin/plugin.json, not by an individual marketplace.json plugin entry.
Affected files
create-plugin/skills/create-plugin-scaffold/SKILL.md, lines 50–53schemas/marketplace.schema.json, lines 54–79schemas/plugin.schema.json, lines 59–71scripts/validate-plugins.mjs, lines 34–49
Steps to reproduce
-
Add a plugin entry containing one of the documented fields to
.cursor-plugin/marketplace.json:{ "name": "example-plugin", "source": "example-plugin", "keywords": ["example"] } -
Run the repository validator.
-
Validation fails because
keywordsis an additional property:marketplace.json schema validation failed: /plugins/0: must NOT have additional properties
The same failure occurs with category or tags.
Expected behavior
The scaffold instructions should produce a marketplace entry that conforms to schemas/marketplace.schema.json.
Actual behavior
Following the skill as written can generate an invalid marketplace entry that fails repository validation.
Proposed fix
Update step 6 of create-plugin-scaffold/SKILL.md to state that a marketplace plugin entry accepts:
- Required:
name,source - Optional:
description,minClientVersions
Clarify that keywords, category and tags belong in the plugin's .cursor-plugin/plugin.json manifest.
Acceptance criteria
- The skill no longer recommends unsupported properties in a marketplace plugin entry.
- The skill clearly distinguishes marketplace entry metadata from plugin manifest metadata.
- An entry created by following the documented instructions passes
scripts/validate-plugins.mjs.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Read create-plugin/skills/create-plugin-scaffold/SKILL.md step 6 alongside schemas/marketplace.schema.json and schemas/plugin.schema.json. Update the documented marketplace fields and clarify the plugin manifest fields, then run scripts/validate-plugins.mjs; done means the instructions describe only schema-supported marketplace properties and validation passes.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- javascript, json, markdown
- Domain
- documentation, tooling
- Issue type
- Documentation
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Activity status
- Active
- Clarity
- Clearly specified
- Newbie friendliness
- 92/100