integrations/claude-plugin

Source of truth for the researchos-plugins Claude Code marketplace (WS-11 Slice 3, docs/plans/WS-11-bring-your-own-ai.md §Slice 3). This directory lives inside the ResearchTeam monorepo, but the published marketplace is a separate git repo — /plugin marketplace add <owner>/<repo> clones a repo directly, it cannot point at a subdirectory of this one. scripts/sync-claude-plugin.ts mirrors this directory out to that repo.

Layout

integrations/claude-plugin/
├── .claude-plugin/
│   └── marketplace.json          # marketplace manifest — lists the "researchos" plugin
└── plugins/
    └── researchos/
        ├── .claude-plugin/
        │   └── plugin.json       # plugin manifest — name, version, author, homepage, keywords
        ├── .mcp.json              # registers the researchos MCP server (https://nperseus.com/mcp)
        ├── README.md              # install/usage docs shipped inside the plugin
        ├── agents/
        │   └── researchos-analyst.md   # multi-step analyst persona (reads; writes with confirmation)
        └── skills/
            ├── lineage/SKILL.md              # read
            ├── credit-statement/SKILL.md     # read
            ├── negative-results/SKILL.md     # read
            ├── project-brief/SKILL.md        # read
            ├── log-experiment/SKILL.md       # write
            ├── declare-contribution/SKILL.md # write
            ├── submit-assignment/SKILL.md    # write
            ├── request-release/SKILL.md      # write
            ├── weekly-update/SKILL.md        # read + write
            ├── onboard-me/SKILL.md           # write
            ├── review-queue/SKILL.md         # write, admin scope
            └── invite-member/SKILL.md        # write, admin scope

The eight read-only tools (get_project_context, list_project_experiments, get_dataset_provenance, find_related_negative_results, get_contribution_statement, search_projects, list_my_projects, get_person_profile, WS-11 Slice 1, src/lib/cms/mcp-tools.ts) need only the read scope. WS-13 Slice A/B added 14 member-tier write tools (scope write, capability content.write — src/lib/cms/mcp-write-tools.ts) and 13 admin-tier write tools (scope admin, src/lib/cms/mcp-admin-tools.ts, never granted by default); src/lib/cms/mcp-dispatch.ts merges both into TOOL_SPECS and filters what a given token's scopes can see. All 35 are served by the same remote MCP endpoint at https://nperseus.com/mcp — every call, read or write, is scoped to what the acting person can see or do, exactly as on the site.

Publishing changes

Edit files under this directory as normal (they're part of the ResearchTeam repo — reviewed and committed the same way as everything else here), then mirror them out with:

npx tsx scripts/sync-claude-plugin.ts              # dry run — prints the file list + commit message, touches nothing
npx tsx scripts/sync-claude-plugin.ts --apply       # clones/updates the marketplace repo, commits, pushes
# or: npm run plugin:sync -- --apply

The destination repo (git@github.com:Ayushkiller/researchos-plugins.git by default, override with --repo) is created and made public/private by the repo owner — this script never creates it, only pushes into an existing (possibly empty) one. --mirror <url> additionally pushes the same commit to a second remote (e.g. the tower's self-hosted GitLab group).

Validating

node -e 'JSON.parse(require("fs").readFileSync(".claude-plugin/marketplace.json"))' # from this dir, or run claude plugin validate below
claude plugin validate integrations/claude-plugin   # if the claude CLI is installed

See plugins/researchos/README.md for end-user install and authentication instructions — install the plugin, then sign in with Google in the browser tab Claude Code opens the first time a researchos tool is used. No token to copy or export.