[Integration] obra/superpowers-marketplace — You.com plugin listing

[mouse-value-add]

Target Repository URL

https://github.com/obra/superpowers-marketplace

You.com API(s)

MCP server registration (you-search, you-contents, you-research via MCP server)

Estimated Complexity

small

Integration Description

The Superpowers Marketplace is a curated Claude Code plugin marketplace (1,221⭐) that serves as a centralized catalog for Claude Code plugins, skills, and tools. It currently lists 10+ plugins including episodic-memory, browser automation, journaling MCP, and development tools.

This integration adds You.com as a plugin entry in the marketplace's .claude-plugin/marketplace.json catalog, enabling Claude Code users to discover and install You.com capabilities through the established marketplace infrastructure.

The marketplace already demonstrates the exact integration pattern we need - each plugin entry points to a source repository containing the actual plugin code. This follows the agent-skills distribution model where the marketplace serves as a discovery surface while the actual skills/tools live in dedicated repos.

Target Repo Contributing Guidelines

No formal CONTRIBUTING.md, but the repo shows active community participation with 5+ open plugin addition PRs from external contributors, indicating acceptance of plugin submissions.

Planned Approach

1. Plugin Repository: Use the existing youdotcom-oss/agent-skills repo as the plugin source (already contains Claude Code plugin manifests)

2. Marketplace Entry: Add a You.com plugin entry to .claude-plugin/marketplace.json following the established format:

   • Name: you
   • Source: https://github.com/youdotcom-oss/agent-skills.git
   • Description: Web search, URL content extraction, and research via You.com MCP server
   • Version: 0.5.0

3. Follow Existing Pattern: Mirror the structure of other marketplace entries like private-journal-mcp and episodic-memory which provide MCP servers and skills

This is a pure plugin marketplace listing integration - no code changes needed, just adding You.com to the existing discovery catalog that Claude Code users already browse.

Status Checklist

• Claimed this integration (self-assign)
• Filed issue or opened discussion in target repo
• Opened PR in target repo
• You.com API calls send the standard integration User-Agent (handled by MCP server)
• You.com links in contributed docs carry the standard UTM parameters
• PR merged or rejected

Links

Target repo issue: N/A (direct PR following community precedent)
Target repo PR: obra/superpowers-marketplace#71

Branch URL: https://github.com/mouse-value-add/superpowers-marketplace/tree/feat/add-youdotcom-plugin

Additional Notes

Perfect distribution surface fit: This is exactly the intended use case for plugin marketplaces - centralized discovery of agent capabilities. The Superpowers Marketplace serves as a curated catalog that Claude Code users actively browse for new tools and skills.

High visibility platform: Claude Code is a major coding assistant platform, and this marketplace appears to be a well-maintained community hub for plugin discovery.

Leverages existing distribution: The agent-skills repo already contains proper Claude Code plugin manifests, so this integration simply makes those capabilities discoverable through the marketplace rather than requiring users to manually add the repo.

Community precedent: Multiple external contributors have added plugins via PR, establishing this as an accepted contribution pattern.

Implementation Summary

Integration type: Plugin marketplace listing
Distribution surface: Superpowers Marketplace's .claude-plugin/marketplace.json catalog
Setup/env vars:

• Uses existing agent-skills repo plugin manifests
• Users can install with standard Claude Code commands: /plugin marketplace add obra/superpowers-marketplace then /plugin install you@superpowers-marketplace

Usage example:

/plugin marketplace add obra/superpowers-marketplace
/plugin install you@superpowers-marketplace

Validation performed: JSON syntax validation passed, followed existing plugin entry format, confirmed repository accessibility, version matches agent-skills release.

Fallback behavior: If You.com MCP server is unavailable, skills gracefully degrade to keyless endpoints or provide clear setup instructions.

Tests run: JSON validation, format consistency check against existing entries.

---

User-Agent: Handled automatically by You.com MCP server for all tool calls.

UTM: 2026-08-oss-integrations / utm_source=obra-superpowers-marketplace / utm_content=marketplace on You.com platform links in the plugin documentation.