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.
