Fix Claude Code plugin marketplace schema and update docs by aknysh · Pull Request #2142 · cloudposse/atmos

aknysh · 2026-03-04T16:47:02Z

what

Fix .claude-plugin/marketplace.json schema that caused /plugin marketplace add cloudposse to fail with Invalid schema: plugins.0.source: Invalid input
Change source from "." to "./agent-skills" — the source field must point to the directory containing .claude-plugin/plugin.json
Remove non-standard metadata.pluginRoot field — not part of the Claude Code marketplace schema
Move version/description to top-level marketplace fields where they belong
Remove duplicate plugin-level fields (author, homepage, repository, license, keywords, strict) from the marketplace manifest — these already exist in agent-skills/.claude-plugin/plugin.json
Change category from "integration" to "development" — matches the official Anthropic marketplace which uses development, productivity, learning, and security
Add uninstall/marketplace remove commands to all documentation (PRD, blog, agent-skills doc, ai-assistants doc)
Fix PRD plugin.json example to match the actual agent-skills/.claude-plugin/plugin.json file
Fix PRD Team Auto-Discovery section to include extraKnownMarketplaces (was missing, wouldn't work without it)

why

The original marketplace.json used "source": "." with a custom metadata.pluginRoot field to resolve the path. This is not part of the Claude Code marketplace schema — Claude Code expects source to directly point to the plugin directory containing .claude-plugin/plugin.json
Users running /plugin marketplace add cloudposse/atmos got an opaque validation error with no guidance on what was wrong
Documentation was missing uninstall/remove instructions, and the PRD had stale examples that didn't match the actual manifest files

Verified fix works locally:

/plugin marketplace add cloudposse/atmos   → Successfully added marketplace: cloudposse
/plugin install atmos@cloudposse           → ✓ Installed atmos
/plugin uninstall atmos@cloudposse         → ✓ Uninstalled atmos
/plugin marketplace remove cloudposse      → ✔ Removed 1 marketplace

references

Claude Code Plugin Marketplaces documentation
Anthropic's official marketplace.json — reference for valid category values and schema structure
Official Claude Code plugins directory
PR Add AI Agent Skills for LLM-Powered Infrastructure Development #2121 that introduced the original marketplace.json

Summary by CodeRabbit

Documentation
- Added uninstall instructions for the Atmos plugin across multiple documentation pages.
Chores
- Updated plugin configuration and restructured marketplace metadata.
- Added support for additional marketplace sources to streamline plugin discovery and auto-configuration.

…nstall commands Fix the Claude Code plugin marketplace schema that caused `/plugin marketplace add cloudposse` to fail with "Invalid schema: plugins.0.source: Invalid input". Changes: - Fix `source` from `"."` to `"./agent-skills"` (must point to plugin.json dir) - Remove non-standard `metadata.pluginRoot` field - Move `version`/`description` to top-level marketplace fields - Remove duplicate plugin-level fields (already in plugin.json) - Change `category` from `"integration"` to `"development"` (official value) - Add uninstall/remove commands to all docs - Fix PRD plugin.json example to match actual file - Fix PRD Team Auto-Discovery to include `extraKnownMarketplaces` Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

github-actions · 2026-03-04T16:48:21Z

Dependency Review

✅ No vulnerabilities or license issues found.

Scanned Files

None

coderabbitai · 2026-03-04T17:04:13Z

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 478d4b26-15e9-4559-a535-39895e749d90

📥 Commits

Reviewing files that changed from the base of the PR and between 74b4aae and aa5b418.

📒 Files selected for processing (5)

.claude-plugin/marketplace.json
docs/prd/atmos-agent-skills.md
website/blog/2026-02-27-ai-agent-skills.mdx
website/docs/integrations/ai/agent-skills.mdx
website/docs/projects/setup-editor/ai-assistants.mdx

📝 Walkthrough

Walkthrough

The pull request restructures the Atmos plugin marketplace configuration by promoting version and description fields to the top level, removing the metadata block, and repointing the plugin source from the root directory to an ./agent-skills subdirectory. Documentation across multiple sites has been updated with uninstall instructions.

Changes

Cohort / File(s)	Summary
Marketplace & Plugin Configuration `.claude-plugin/marketplace.json`, `agent-skills/.claude-plugin/plugin.json`	Updated marketplace manifest with top-level version and description fields; removed metadata block. Plugin source redirected from root to `./agent-skills`. Plugin metadata consolidated; homepage, repository, and keywords updated. Category changed from "integration" to "development".
Documentation Updates `docs/prd/atmos-agent-skills.md`, `website/blog/2026-02-27-ai-agent-skills.mdx`, `website/docs/integrations/ai/agent-skills.mdx`, `website/docs/projects/setup-editor/ai-assistants.mdx`	Added uninstall instructions for the Atmos plugin across documentation and blog content. Instructions include commands to remove the plugin and optionally the marketplace configuration.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~15 minutes

Suggested labels

patch

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately describes the main changes: fixing the marketplace schema and updating documentation to align with Claude Code plugin requirements.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

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

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create PR with unit tests
Post copyable unit tests in a comment
Commit unit tests in branch aknysh/fix-agent-skills

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.}

codecov · 2026-03-04T17:17:05Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 76.60%. Comparing base (74b4aae) to head (aa5b418).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #2142      +/-   ##
==========================================
+ Coverage   76.57%   76.60%   +0.02%     
==========================================
  Files         832      832              
  Lines       79524    79524              
==========================================
+ Hits        60898    60919      +21     
+ Misses      14830    14813      -17     
+ Partials     3796     3792       -4

Flag	Coverage Δ
unittests	`76.60% <ø> (+0.02%)`	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.
see 5 files with indirect coverage changes

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

github-actions · 2026-03-05T00:47:41Z

These changes were released in v1.208.1-test.0.

aknysh requested a review from a team as a code owner March 4, 2026 16:47

aknysh added the no-release Do not create a new release (wait for additional code changes) label Mar 4, 2026

aknysh self-assigned this Mar 4, 2026

github-actions bot added the size/m Medium size PR label Mar 4, 2026

github-actions bot deployed to preview March 4, 2026 16:52 View deployment

aknysh requested a review from osterman March 4, 2026 16:58

osterman approved these changes Mar 4, 2026

View reviewed changes

coderabbitai bot approved these changes Mar 4, 2026

View reviewed changes

aknysh merged commit 7091aa6 into main Mar 4, 2026
102 of 103 checks passed

aknysh deleted the aknysh/fix-agent-skills branch March 4, 2026 17:52

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Fix Claude Code plugin marketplace schema and update docs#2142

Fix Claude Code plugin marketplace schema and update docs#2142
aknysh merged 1 commit intomainfrom
aknysh/fix-agent-skills

aknysh commented Mar 4, 2026 •

edited by coderabbitai bot

Loading

Uh oh!

github-actions bot commented Mar 4, 2026

Uh oh!

coderabbitai bot commented Mar 4, 2026

Walkthrough

Changes

Estimated code review effort

Suggested labels

Uh oh!

codecov bot commented Mar 4, 2026 •

edited

Loading

Uh oh!

Uh oh!

github-actions bot commented Mar 5, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

aknysh commented Mar 4, 2026 • edited by coderabbitai bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

what

why

references

Summary by CodeRabbit

Uh oh!

github-actions bot commented Mar 4, 2026

Dependency Review

Scanned Files

Uh oh!

coderabbitai bot commented Mar 4, 2026

Walkthrough

Changes

Estimated code review effort

Suggested labels

Uh oh!

codecov bot commented Mar 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

Uh oh!

github-actions bot commented Mar 5, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

aknysh commented Mar 4, 2026 •

edited by coderabbitai bot

Loading

codecov bot commented Mar 4, 2026 •

edited

Loading