Skip to content

Add ubcode Claude Code plugin to pharaoh marketplace #1

@patdhlk

Description

@patdhlk

Summary

Pharaoh's marketplace (marketplace.json) currently only lists the pharaoh plugin itself. We should add a companion ubcode Claude Code plugin to the marketplace so that ubcode customers can install enhanced sphinx-needs support for Claude Code directly from the pharaoh marketplace.

Background

  • Pharaoh already references ubCode MCP as Tier 2 in its three-tier data access pattern (skills/shared/data-access.md, line 122–131). Skills check for MCP tools containing ubcode or useblocks and use them for querying the needs index, resolving links, and validating schema.
  • ubcode is a VS Code extension that provides a full LSP for reStructuredText and sphinx-needs, including an embedded MCP server (server/mcp/ubc_mcp_server). It offers completions, go-to-definition, references, hover, formatting, diagnostics, and a needs graph viewer.
  • Claude Code supports installing plugins from GitHub marketplaces via /plugin marketplace add owner/repo, then /plugin install plugin-name@marketplace-name.

Proposal

  1. Create a ubcode Claude Code plugin (either in this repo or sourced from useblocks/ubcode) that provides:

    • A setup skill for configuring the ubcode MCP server connection in Claude Code's MCP settings (so Tier 2 data access works out of the box)
    • Optional skills leveraging ubcode MCP tools directly (e.g., needs querying, graph exploration, diagnostics)
    • Documentation on the ubcode + pharaoh integration experience tiers
  2. Register it in marketplace.json so users can install both plugins from a single marketplace:

    {
      "plugins": [
        {
          "name": "pharaoh",
          "description": "AI assistant framework for sphinx-needs projects",
          "version": "0.1.0",
          "source": "./"
        },
        {
          "name": "ubcode",
          "description": "Claude Code integration for ubcode VSCode extension MCP server",
          "version": "0.1.0",
          "source": "./plugins/ubcode"
        }
      ]
    }
  3. User workflow would then be:

    /plugin marketplace add patdhlk/pharaoh
    /plugin install pharaoh@pharaoh-dev
    /plugin install ubcode@pharaoh-dev
    

Acceptance Criteria

  • ubcode plugin with at least a setup skill for MCP server configuration
  • marketplace.json lists both pharaoh and ubcode plugins
  • README documents the installation steps and experience tiers (Basic → Good → Best)
  • Pharaoh's data-access Tier 2 works seamlessly when ubcode plugin is installed and the VS Code extension is running

Related

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions