shared-mcp

AI Marketplace

A skill-first repository for reusable agent workflows, packaged for multiple agent runtimes and installable from Codex via npx skills.

What is This?

This repository serves as a marketplace for reusable agent workflows across agent runtimes. Claude Code packaging is still supported, but the canonical workflows live in plugins/*/skills/*.

Available Plugins

Plugin	Description	Requirements
shared-mcp	INSTALL FIRST - MCP infrastructure for web search (Brave, Tavily, Exa)	Node.js, BRAVE_API_KEY, TAVILY_API_KEY, EXA_API_KEY
p-assist	Productivity: expenses, RSS, VPS	shared-mcp, N8N_API_TOKEN
common-engineering	Engineering tools: code review, Mermaid diagrams, tech docs (RFCs, proposals, ADRs)	shared-mcp, mermaid-cli, CONTEXT7_API_KEY
sys-maint	System maintenance: Docker cleanup, disk analysis	macOS only
thinking-tools	Thinking tools: pressure-test ideas (idea-refinery) and drill into execution plans (grill-me)	None
softskills	Office politics coach for navigating workplace dynamics	None

See individual plugin READMEs for detailed setup instructions.

Available Skills

Skills are model-invoked capabilities that agent runtimes can activate when triggered by natural language. They are organized by plugin:

common-engineering Skills

Skill	Trigger Phrases	Output
code-review	"review my code", "review this branch", "check my diff"	Structured review report with severity-classified findings
mermaid	"create a diagram", "draw architecture", "sequence diagram for..."	Validated Mermaid diagrams (sequence, architecture, flowchart)
one-pager	"write a one-pager", "create a proposal", "draft a one-pager"	1-3 page stakeholder approval document
adr	"write an ADR", "document architecture decision", "compare X vs Y"	1-3 page Architecture Decision Record
rfc	"write an RFC", "design proposal for cross-team review"	5-15 page Request for Comments
tsd	"write a TSD", "document an API", "API spec"	5-20 page Technical Specification Document
poc-experiment	"write a POC document", "Go/No-Go recommendation"	3-8 page proof of concept with decision
project-management-plan	"project plan excel", "Gantt chart", "project tracker"	Excel workbook with 4 tabs (plan, charters, budget, RAID)
web-researcher	"search the web", "find online", "research", "look up", "debug error", "latest news about", "investigate company"	Findings with inline citations, recommendations, and source links. Routes via Brave (discovery) → Tavily (extraction) → Exa (semantic/technical)

thinking-tools Skills

Skill	Trigger Phrases	Output
idea-refinery	"pressure-test my idea", "sparring partner", "gut-check this idea", "is this worth doing"	Concise Idea Brief with problem, MVP, risks, next actions
grill-me	"grill me", "interrogate my idea/plan", "stress-test this", "drill into this", "poke holes in it", "help me think through whether to pursue this"	Decision Summary — every branch resolved, whether viability or execution

softskills Skills

Skill	Trigger Phrases	Output
office-politics-coach	"office politics", "navigate this situation", "difficult coworker"	Reframe, options, and word-for-word scripts for workplace dynamics

Quick Start

1. Add Marketplace

/plugin marketplace add https://github.com/irfansofyana/ai-marketplace

2. Configure Environment Variables

Add to ~/.zshrc (macOS) or ~/.bashrc (Linux):

export TAVILY_API_KEY="your-tavily-api-key"     # https://tavily.com
export EXA_API_KEY="your-exa-api-key"           # https://exa.ai
export N8N_API_TOKEN="your-n8n-token"           # https://n8n.io (for p-assist)

Reload: source ~/.zshrc or source ~/.bashrc

3. Install Plugins (in dependency order)

/plugin install shared-mcp@ai-marketplace     # REQUIRED - install first
/plugin install p-assist@ai-marketplace       # Optional
/plugin install common-engineering@ai-marketplace  # Optional
/plugin install sys-maint@ai-marketplace      # Optional (macOS only)
/plugin install thinking-tools@ai-marketplace # Optional
/plugin install softskills@ai-marketplace     # Optional

Manual Installation (Alternative)

For local development or offline access:

git clone https://github.com/irfansofyana/ai-marketplace.git
cd ai-marketplace
/plugin marketplace add $(pwd)

Codex and Skills

This repo's existing plugins/*/skills/* structure is already discoverable by npx skills add. No extra wrapper layer is required for Codex.