## Why
Several small quality issues accumulated across plugin-author and
marketplace-author: the plugin-author description was ambiguous about
scope, the ADD flow asked an unnecessary clarifying question when local
path is the obvious default, VALIDATE had redundant wording already
captured inline, the keywords field was missing from the validation
checklist, and tests/README.md was a placeholder with nothing to test.
## Implementation Notes
- plugin-author: tightened description scope to "inside those
directories"; added `keywords` identical-in-both-manifests check to
VALIDATE checklist.
- marketplace-author: moved reserved-prefix constraint from gotchas
into the ADD checklist item; replaced the four-option prompt with a
default+escape-hatch ("I'll treat this as local path — is that right?");
folded the validate-from-root note inline and removed trailing padding;
deleted tests/README.md — no scripts/ directory exists, so the
placeholder was noise.
- README.md: removed the tests/README.md row from the file table.
plugin-author
Creates, updates, and releases plugin scaffolds for the holocron marketplace.
What it does
Manages both manifests (plugin.json for Copilot CLI and .claude-plugin/plugin.json for Claude Code) in one pass. Three operations: create a new plugin scaffold with placeholder manifests and skeleton dirs; update configuration fields (shared fields updated in both manifests simultaneously); release a version with HITL gate before tagging.
Out of scope: plugin content (skills, agents, hooks, MCP servers inside those dirs) and marketplace.json entries.
Before you start
Have ready: the plugin name (kebab-case) and the repo root path.
Usage
/plugin-author
Manual scaffold (human workflow):
bash scripts/new-plugin.sh <plugin-name> <repo-root>
# Examples:
bash scripts/new-plugin.sh my-tools /root/ai-development
bash scripts/new-plugin.sh data-tools .
Files
| File | Purpose |
|---|---|
SKILL.md |
Skill instructions for agents |
scripts/new-plugin.sh |
Scaffolds both manifests and skeleton dirs for a new plugin |
references/manifest-fields.md |
All optional fields for both manifests beyond the scaffolded defaults |
references/sources.md |
Research provenance — sources that informed this skill |
scripts/README.md |
Directory meta-documentation for scripts/ |
references/README.md |
Directory meta-documentation for references/ |