Skip to content

docs: prepare Claude Code plugin marketplace release notes#291

Open
Darkroom4364 wants to merge 1 commit intomainfrom
issue-285-claude-plugin-release-notes
Open

docs: prepare Claude Code plugin marketplace release notes#291
Darkroom4364 wants to merge 1 commit intomainfrom
issue-285-claude-plugin-release-notes

Conversation

@Darkroom4364
Copy link
Copy Markdown
Collaborator

@Darkroom4364 Darkroom4364 commented May 6, 2026

Summary

Verification

  • git diff --check
  • printf {tool_input.file_path=tests/fixtures/safe.py} | plugins/claude-code/scripts/scan-edited-file.sh exits 0 and stays silent.
  • printf {tool_input.file_path=tests/fixtures/vulnerable.py} | plugins/claude-code/scripts/scan-edited-file.sh exits 2 and emits a 37-finding stderr summary.
  • printf {tool_input.path=tests/fixtures/vulnerable.py} | plugins/claude-code/scripts/scan-edited-file.sh exits 2.
  • printf {tool_input.file_path=/does/not/exist.py} | plugins/claude-code/scripts/scan-edited-file.sh exits 0 and stays silent.

Notes

claude plugin validate plugins/claude-code was attempted locally with Claude Code 2.1.119, but it did not return and was stopped. In-session Claude Code smoke testing remains tracked in #285.

Closes part of #285.
Related: #290

Summary by CodeRabbit

  • Documentation
    • Enhanced publishing documentation directing users to new marketplace release notes and submission guidance
    • Introduced comprehensive marketplace documentation file with versioning discipline, submission copy templates, demo checklist, and local validation procedures with example commands
    • Updated README to include marketplace submission references and clarification of package scope specific to Claude Code

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 6, 2026

📝 Walkthrough

Walkthrough

This PR adds comprehensive marketplace documentation for the Claude Code plugin, including publishing guidelines, versioning discipline, submission copy templates, and local validation procedures across three documentation files.

Changes

Claude Code Marketplace Documentation

Layer / File(s) Summary
New Marketplace Reference
plugins/claude-code/MARKETPLACE.md
New file containing Claude Code Marketplace Release Notes with versioning discipline, marketplace copy (name, descriptions, repository, license, categories), demo checklist, local validation steps with example commands and expected results, and external submission guidance.
Plugin README Integration
plugins/claude-code/README.md
Added Marketplace section under Install directing users to MARKETPLACE.md for submission copy and validation commands; added Notes section clarifying Claude Code scope and separating broader integration design as a separate task.
Integration Documentation
docs/claude-code-integration.md
Expanded Publishing Status section to reference MARKETPLACE.md for publishing details and clarify that the integration is Claude Code-specific with future generalization as a separate tracking item.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Possibly related issues

  • Issue #285: Directly implements the marketplace copy and publishing guidance referenced in the "Publish Claude Code plugin" checklist.

Possibly related PRs

  • PwnKit-Labs/foxguard#286: Both PRs modify Claude Code integration documentation and README with overlapping publishing and marketplace content.
  • PwnKit-Labs/foxguard#282: Both PRs update Claude Code plugin documentation and add marketplace/integration guidance for the same plugin.

Poem

🐰 A marketplace awaits, with docs so bright,
Release notes and checklists, all just right,
Versioning and copy, validation divine,
The Claude Code plugin now ready to shine! ✨

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The PR title 'docs: prepare Claude Code plugin marketplace release notes' directly and clearly describes the main change: preparing marketplace release documentation for the Claude Code plugin.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch issue-285-claude-plugin-release-notes

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/claude-code-integration.md`:
- Line 85: Update the ambiguous phrase in docs/claude-code-integration.md
("GitHub issue linked from the README/PR queue") to be explicit: either replace
it with the exact issue number (e.g., "GitHub issue `#285`"), remove the clause
and point readers to plugins/claude-code/MARKETPLACE.md only, or reword to "the
GitHub issue tracking the marketplace release" so it clearly references the
marketplace release issue; ensure the final sentence also retains the existing
MARKETPLACE.md reference.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 4b68017c-c98a-4561-bc06-91a30b6dc6e1

📥 Commits

Reviewing files that changed from the base of the PR and between 981de86 and 46fa7ba.

📒 Files selected for processing (3)
  • docs/claude-code-integration.md
  • plugins/claude-code/MARKETPLACE.md
  • plugins/claude-code/README.md

The plugin can be loaded locally today with `--plugin-dir`. Publishing to an official Claude plugin marketplace is an external release step: it requires final marketplace metadata, a release/versioning decision, local plugin smoke testing in Claude Code, and submission through Anthropic's plugin form.

Track the publishing checklist in the GitHub issue linked from the README/PR queue rather than treating it as part of the scanner binary release.
Track the publishing checklist in the GitHub issue linked from the README/PR queue rather than treating it as part of the scanner binary release. Marketplace copy, versioning notes, and local validation commands live in [`plugins/claude-code/MARKETPLACE.md`](../plugins/claude-code/MARKETPLACE.md).
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Clarify the GitHub issue reference.

The phrase "GitHub issue linked from the README/PR queue" is vague. Consider either:

  • Specifying the exact issue number (e.g., "issue #285")
  • Removing the reference entirely since MARKETPLACE.md already contains the checklist
  • Using clearer phrasing like "the GitHub issue tracking the marketplace release"
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/claude-code-integration.md` at line 85, Update the ambiguous phrase in
docs/claude-code-integration.md ("GitHub issue linked from the README/PR queue")
to be explicit: either replace it with the exact issue number (e.g., "GitHub
issue `#285`"), remove the clause and point readers to
plugins/claude-code/MARKETPLACE.md only, or reword to "the GitHub issue tracking
the marketplace release" so it clearly references the marketplace release issue;
ensure the final sentence also retains the existing MARKETPLACE.md reference.

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.

1 participant