lucasilverentand/publishing
plugins/skill-creation/skills/publishing/SKILL.md
Manages Codex, Claude Code, and Cursor skill marketplaces — publishes plugin-owned skills, updates plugin groups, removes entries, packages skills for distribution, regenerates plugin manifests, and validates catalog integrity. Use when publishing a skill to the marketplace, bumping a version, removing a skill from the catalog, packaging a skill as a .skill file, regenerating marketplace files, moving a skill between plugins, or fixing marketplace validation errors.
$ install --global
skillsauthnpx skillsauth add lucasilverentand/skills publishingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 28, 2026, 7:09 AM43.9s6 files scanned
SKILL.md
- name:
- publishing
- description:
- Manages Codex, Claude Code, and Cursor skill marketplaces — publishes plugin-owned skills, updates plugin groups, removes entries, packages skills for distribution, regenerates plugin manifests, and validates catalog integrity. Use when publishing a skill to the marketplace, bumping a version, removing a skill from the catalog, packaging a skill as a .skill file, regenerating marketplace files, moving a skill between plugins, or fixing marketplace validation errors.
- allowed-tools:
- Read Grep Glob Bash Write Edit
Skill Publishing
Decision Tree
- What are you doing?
- Publishing a skill to the marketplace -> follow "Publishing" below
- Updating a published skill -> what changed?
- Bug fix or wording tweak -> bump patch version in
metadata.versionof marketplace.json - New skills, new tools, or backwards-compatible additions -> bump minor version
- Breaking changes (removed skills, renamed categories, restructured) -> bump major version
- Bug fix or wording tweak -> bump patch version in
- Removing a skill from the marketplace -> follow "Removing" below
- Moving a skill to a different plugin -> move
plugins/<old>/skills/<skill>toplugins/<new>/skills/<skill>, updateplugin-groups.json, then runbun run marketplace:write - Packaging a skill for distribution -> run
scripts/package-skill.ts <path/to/skill-folder> - Validating marketplace.json -> run
bun run marketplace, fix any errors perreferences/marketplace-errors.md - Regenerating marketplace.json from disk -> follow "Regenerating manifests" below
Publishing
- Ensure the skill directory exists at
plugins/<plugin>/skills/<skill-name>/SKILL.md - Run the validator:
bun run plugins/skill-creation/skills/publishing/scripts/quick-validate.ts plugins/<plugin>/skills/<skill-name> - Add the skill name to exactly one plugin entry in
plugin-groups.json - Run
bun run marketplace:writeto regenerate:plugins/<name>/.claude-plugin/plugin.jsonplugins/<name>/.codex-plugin/plugin.jsonplugins/<name>/.cursor-plugin/plugin.jsonplugins/<name>/README.md.claude-plugin/marketplace.json.cursor-plugin/marketplace.json.agents/plugins/marketplace.json
- Run
bun run marketplaceagain; it must report everything up to date
For bulk additions, update plugin-groups.json first, then regenerate once.
Removing
- Remove the skill name from its plugin in
plugin-groups.json - Delete
plugins/<plugin>/skills/<skill-name>/ - Bump the marketplace version — minor if backwards-compatible, major if consumers depended on it
- Run
bun run marketplace:write, thenbun run marketplace
Regenerating manifests
To rebuild plugin manifests and marketplaces from the plugin-owned source tree:
- Edit skills under
plugins/<plugin>/skills/ - Edit plugin metadata or skill ownership in
plugin-groups.json - Run
bun run marketplace:write - Review the generated diff under plugin manifests, plugin READMEs,
.claude-plugin/,.cursor-plugin/, and.agents/plugins/ - Run
bun run marketplaceto confirm no generated files are stale
Marketplace conventions
See references/marketplace-schema.md for the full schema. Key conventions:
- Skill source:
plugins/<name>/skills/<skill-name>/directories are authored directly - Generated files: plugin manifests, plugin READMEs, and marketplace files are overwritten by
bun run marketplace:write - Naming: lowercase alphanumeric + hyphens, 1-64 characters
- Versioning:
plugin-groups.jsonmetadata.versiontracks both marketplace versions using semver - Codex marketplace: generated at
.agents/plugins/marketplace.json - Claude marketplace: generated at
.claude-plugin/marketplace.json - Cursor marketplace: generated at
.cursor-plugin/marketplace.json(team-template layout withmetadata.pluginRoot) - Cursor validation:
bun run validate:cursorafter regenerating Cursor artifacts - Commands: command shims may be used for explicit Codex, Claude, and Cursor slash-command entrypoints; portable workflows should still be skills
Key references
|File|What it covers|
|---|---|
|references/marketplace-schema.md|Codex, Claude, and Cursor marketplace schemas, plugin manifests, and source types|
|references/marketplace-errors.md|Validation error codes and fixes|
|plugin-groups.json|Source of truth for plugin grouping and metadata|
|scripts/marketplace.ts|Regenerates both marketplaces and plugin manifests|
|scripts/quick-validate.ts|Quick SKILL.md frontmatter validation|
|scripts/package-skill.ts|Packages a skill folder into a distributable .skill zip file|
Related Skills
lucasilverentand/open-source-docs
tools
VerifiedTrustedCommunity
Creates, audits, and updates public open-source repository documentation, including README files, CONTRIBUTING guides, SECURITY and SUPPORT docs, project badges, quickstarts, usage guidance, community links, and contributor onboarding. Use when maintaining docs for public GitHub projects, libraries, CLIs, apps, or reusable packages, especially when the user says "update this README", "write CONTRIBUTING.md", "make these docs open-source ready", or "improve the public project docs".
3SKILL.mdUpdated Jun 5, 2026
lucasilverentand/closed-source-docs
development
VerifiedTrustedCommunity
Creates, audits, and updates private or closed-source project documentation, including internal README hubs, codebase navigation guides, ownership links, Linear initiative links, onboarding notes, runbooks, and contribution guidance for teams. Use when maintaining docs for private repositories, internal apps, services, infrastructure, or company projects, especially when the user says "make this README an internal hub", "document how to navigate this repo", "add Linear links to the docs", or "write private project documentation".
3SKILL.mdUpdated Jun 5, 2026
lucasilverentand/linear-issues
development
VerifiedTrustedCommunity
Creates, updates, estimates, and tidies Linear issues using Luca's issue-shaping rules. Use when the user asks to create a Linear issue, write ticket-ready issue text, refine an existing issue, add acceptance criteria, set issue relationships, estimate points, audit issue hygiene, tidy a Linear project, find duplicates, fix stale blockers, or normalize labels, milestones, priorities, and issue state.
3SKILL.mdUpdated Jun 5, 2026
lucasilverentand/tidy-linear-project
testing
VerifiedTrustedCommunity
Keeps an existing Linear project tidy after planning and during execution. Use when the user asks to "tidy Linear", "clean up the project", "audit issues", "find duplicates", "check stale blockers", "fix project drift", or run periodic Linear housekeeping on a project, initiative, or milestone set. Use when planning is underway or execution has started and relationships, labels, priorities, documents, and issue states need coherence without changing product scope.
3SKILL.mdUpdated May 29, 2026