← Back to Documentation

Plugin Architecture

core-dependencies operating layer · division plugins · the marketplace.json registry model

Marketplace-First Install Model

.claude-plugin/marketplace.json (seer-agent-core, v7.17.0) is the single registry /plugin install resolves against. Every entry in its plugins[] array carries name, source (a path under plugins/), description, version, and a skills[] list of skill directory paths — there is no separate dependency-resolution mechanism, so core-dependencies is modeled as a required foundation plugin rather than an npm-style dependency. 

graph TD
  MP["marketplace.json
seer-agent-core v7.17.0
plugins[] registry"]

  subgraph CORE["1 · REQUIRED OPERATING LAYER"]
    CD["core-dependencies v4.5.3
9 skills"]
    HOOKS["hooks.json
UserPromptSubmit → skill-activation.mjs
PostToolUse(Edit/Write) → post-tool-use.mjs
Stop → stop-qa-check.mjs"]
    CD --- HOOKS
  end

  subgraph DIV["2 · DIVISION PLUGINS · thin, no shared logic"]
    SEO["seo v4.7.2 · 11 skills"]
    PDM["pdm v4.0.3 · 7 skills"]
    ANA["analytics v3.1.2 · 7 skills"]
    CRE["creative · 8 skills"]
    OPS["operations · 4 skills"]
    OTHER["bd · cs · px · seer-xdiv
data-fieldguides"]
  end

  subgraph LAB["3 · LAB / INFRA"]
    INNO["innovation · 8 skills"]
    PREV["preview · 12 skills
staging for -pre skills"]
    WIL["wil · 17 skills"]
    MCPI["mcp-integrations
plugins/infrastructure/mcp-servers"]
  end

  MP -->|resolves install for| CD
  MP -->|resolves install for| DIV
  MP -->|resolves install for| LAB
  CD -.->|required before any division plugin| SEO
  CD -.->|required before any division plugin| PDM
  CD -.->|required before any division plugin| ANA
  CD -.->|required before any division plugin| CRE
  CD -.->|required before any division plugin| OPS
  CD -.->|required before any division plugin| OTHER

  class CD,HOOKS core;
  class SEO,PDM,ANA,CRE,OPS,OTHER div;
  class INNO,PREV,WIL,MCPI lab;
marketplace resolution required-before dependency
Separation of Concerns

core-dependencies — the operating layer. Ships the skill-activation engine (scripts/skill-activation.mjs, fired on UserPromptSubmit), shared writing/quality standards, and QA checkpoints (stop-qa-check.mjs on Stop). Every division plugin depends on it; it depends on none of them.

Division plugins — domain-specific workflows (SEO, Analytics, Paid Media, Creative, Operations, BD, CS, PX, Cross-Division) with no duplicated shared logic; they consume core-dependencies' standards rather than re-implementing them.

Registry Snapshot — .claude-plugin/marketplace.json
PluginSourceSkillsRole
core-dependencies./plugins/core-dependencies9required operating layer
seo./plugins/divisions/seo11division
pdm./plugins/divisions/pdm7division
analytics./plugins/divisions/analytics7division
creative./plugins/divisions/creative8division
innovation./plugins/divisions/innovation8division
operations./plugins/divisions/operations4division
data-fieldguides./plugins/data-fieldguides4division
cs./plugins/divisions/cs4division
px./plugins/divisions/px2division
seer-xdiv./plugins/seer-xdiv4division
bd./plugins/divisions/bd1division
mcp-integrations./plugins/infrastructure/mcp-servers0infrastructure
preview./plugins/preview12lab staging for -pre skills
experimental./plugins/experimental0lab
wil./plugins/wil17division

16 plugins total, per .claude-plugin/marketplace.json (metadata.version 7.17.0). Skill counts are the length of each entry's skills[] array.

core-dependencies Skills