Skip to content

Prepare the plugin for community-marketplace submission (JPA-4586) - #30

Merged
paltsevpaveljoom merged 1 commit into
mainfrom
jpa-4586-plugin-submission-readiness
Aug 13, 2026
Merged

Prepare the plugin for community-marketplace submission (JPA-4586)#30
paltsevpaveljoom merged 1 commit into
mainfrom
jpa-4586-plugin-submission-readiness

Conversation

@paltsevpaveljoom

Copy link
Copy Markdown
Collaborator

Summary

Review of this repo against the current Claude plugin submission requirements
(internal ticket JPA-4586). It was not ready — two blockers, both fixed here.

Worth recording: there is no application process for the official
marketplace (claude-plugins-official); Anthropic curates it at its discretion.
Third-party submissions go to the community marketplace
(claude-plugins-community) via an in-app form. This PR prepares the repo for
that submission.

Blocker 1 — stale repo name

The repo was renamed pulse-skillsjoompulse-skills, but the manifests and
README were never updated. Both homepage/repository URLs and the install
commands still pointed at joomcode/pulse-skills, which resolved only through
GitHub's rename redirect.

The plugin is renamed to joompulse-skills to match the repo and the brand, and
all six stale references are fixed. A plugin name is a permanent identifier
once published
— renaming after approval breaks every existing install — so
this is the last point at which the rename costs nothing. Skills now invoke as
/joompulse-skills:<skill>.

Blocker 2 — version drift

plugin.json said 0.1.0 while the changelog carried three skills under
"Unreleased" and thirteen more that were never recorded at all. There were no
tags or releases. Disagreement between manifest, changelog and tags is the most
common cause of submission rejection. This cuts 0.2.0 and rebuilds the entry
from the actual git history.

After merge this should be tagged v0.2.0 to keep the versioning contract intact.

Also included

  • Bundled .mcp.json so installing the plugin configures the JoomPulse
    connector and the user only has to sign in. All 17 skills hard-require it, and
    review weighs how fast an unfamiliar user can get a plugin working. The README
    keeps the manual steps for Claude chat and Cowork, where it is still added by hand.
  • scripts/check-manifests.sh + CI workflow covering exactly what broke here:
    name/version/URL agreement across both manifests and the changelog, plus skill
    frontmatter and the 1024-character description limit. claude plugin validate
    runs unauthenticated, so it works in CI.
  • gitignored skills.zip, a build artifact that was sitting untracked.

Verification

claude plugin validate . --strict, check-public-safety.sh and
check-manifests.sh all pass. Already fine before this PR: directory layout
matches spec, all 17 skills have valid name+description frontmatter (longest
1017 chars), and MIT/SECURITY.md/CONTRIBUTING.md are present.

Notes for the reviewer

  • The 0.2.0 date is set to 2026-08-13. If the release lands later, move it.
  • The name change is the one irreversible decision here; worth a deliberate look
    before merge.

Public-Safety Checklist

  • No credentials, tokens, keys, or secrets.
  • No internal filesystem paths.
  • No private Slack, Jira, Notion, admin, or service URLs.
  • No private service names or implementation details.
  • No customer data or private product data.
  • Skill directory name matches SKILL.md frontmatter name.

🤖 Generated with Claude Code

Reviewing the repo against the current plugin submission requirements
turned up two blockers.

The repo was renamed pulse-skills -> joompulse-skills, but the manifests
and README were never updated. Both homepage/repository URLs and the
install commands still pointed at joomcode/pulse-skills, which only
resolved via GitHub's rename redirect. Rename the plugin to
joompulse-skills to match the repo and the brand, and fix all six stale
references. The plugin name is a permanent identifier once published, so
this is the last point at which the rename is free.

plugin.json also said 0.1.0 while the changelog carried three skills
under "Unreleased" and thirteen more that were never recorded. Manifest,
changelog and tag disagreement is the most common cause of submission
rejection, so cut 0.2.0 and rebuild the entry from the actual history.

Bundle .mcp.json so installing configures the JoomPulse connector and
the user only has to sign in. All 17 skills hard-require it, and review
weighs how quickly an unfamiliar user can get the plugin working. The
README keeps the manual steps for Claude chat and Cowork, where the
connector is still added by hand.

Add scripts/check-manifests.sh and a CI workflow covering exactly what
broke here: name, version and URL agreement across both manifests and
the changelog, plus skill frontmatter and the 1024-character description
limit. claude plugin validate runs unauthenticated, so it works in CI.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@paltsevpaveljoom
paltsevpaveljoom merged commit c46cbae into main Aug 13, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants