session-retro

<h1 align="center">Fakoli Plugins Marketplace</h1>

Extend Claude Code with production-grade plugins.

A curated collection of battle-tested Claude Code plugins — covering Google Workspace automation, AI image generation, text-to-speech, diagram authoring, secure web fetching, and marketplace self-management. Every plugin ships with skills, commands, agents, and CI validation.

---

Quick Start

Add this marketplace to Claude Code with one command:

/plugin marketplace add fakoli/fakoli-plugins

Then install any plugin:

/plugin install gws
/plugin install safe-fetch
/plugin install nano-banana-pro

---

What are Claude Code Plugins?

Claude Code plugins extend the assistant with domain-specific capabilities. A plugin can bundle:

Skills — Reusable context files that teach Claude how to use a tool or follow a workflow
Commands — Slash commands (e.g. /send-email, /speak, /fetch) that invoke specific behaviors
Agents — Isolated sub-agents for complex, multi-step operations
Hooks — PreToolUse / PostToolUse interceptors that modify or guard Claude's actions

Plugins live in directories with a .claude-plugin/plugin.json manifest. The marketplace validates every plugin against a JSON Schema on every push and pull request.

---

The Fakoli Ecosystem

The fakoli trinity — three plugins designed to compose, each useful standalone:

| Plugin | Role | What It Does | |--------|------|--------------| | fakoli-flow | Workflow orchestration | Intent-driven pipeline: brainstorm → plan → execute → verify → finish. Wave-based dispatch with mandatory critic gates between every code-writing phase | | fakoli-crew | Specialist agents | 9 polyglot agents (TypeScript / Python / Rust) — architect, reviewer, security auditor, researcher, plugin engineer, integration specialist, documenter, infrastructure engineer, QA | | fakoli-state | Canonical project state | Local-first SQLite state engine for humans and AI coding agents. Lockable, evidence-backed work packets; event-sourced log with rebuildable SQLite projection; CLI + MCP surfaces, bidirectional GitHub Issues sync |

fakoli-flow defines how work moves. fakoli-crew defines who does the work. fakoli-state defines what is true. Together they form the canonical fakoli stack: orchestration + specialists + durable state.

A separate companion plugin, systems-thinking, runs multi-agent infrastructure analysis (discovery → extraction → synthesis) for decisions that affect the whole system — useful before the trinity starts work, but not part of the core stack.

Install any combination — each works standalone. The full trinity gives you a complete multi-agent development pipeline: intent-driven planning, parallel agent execution against canonical state, and evidence-based verification with enforced claim/lock discipline.

How does the trinity compare to Beads, claude-task-master, spec-kit, superpowers, and Claude Code's native Agent Teams? The honest prior-art analysis — what fakoli invented, what it reinvented, and where the moat is — lives in docs/POSITIONING.md.

---

Available Plugins

Google Workspace & Productivity

| Plugin | Description | |--------|-------------| | gws | Full Google Workspace via the gws CLI — 100 skills, 15 commands, 11 role-based agents, and 44 recipes spanning Gmail, Calendar, Drive, Docs, Sheets, Slides, Chat, and more. The most comprehensive Workspace plugin available for any AI assistant. | | notebooklm-enhanced | Programmatic control of Google NotebookLM — create notebooks, ingest PDFs and YouTube videos, generate podcasts and slide decks, and run end-to-end research workflows with a single command. |

AI & Media Generation

| Plugin | Description | |--------|-------------| | nano-banana-pro | Generate, edit, and remix production-ready images with Google Gemini 3 Pro. Includes a 5-agent PaperBanana pipeline (Retriever → Planner → Stylist → Visualizer → Critic) that iteratively refines images until they pass a quality threshold. | | fakoli-speak | Multi-provider TTS for Claude Code — stream any response as speech via /speak using OpenAI ($0.015/1K), Deepgram, ElevenLabs, Google Gemini (free), or macOS Say (free). Switch with /provider, track spending with /cost, toggle auto-narration with /autospeak. | | excalidraw-diagram | Generate .excalidraw files from natural language or by analyzing your codebase. Supports flowcharts, architecture diagrams, ER diagrams, and dependency graphs across four color themes — zero dependencies beyond Node.js 18. |

Security & Web

| Plugin | Description | |--------|-------------| | safe-fetch | Drop-in replacement for Claude's built-in WebFetch and WebSearch that runs content through a 6-layer sanitization pipeline before it touches the LLM. Neutralizes CSS-hidden text, zero-width Unicode, fake LLM delimiters, base64 payloads, and markdown exfiltration vectors. Security-team approvable. |

Development & Workflow

| Plugin | Description | |--------|-------------| | cli-to-plugin | Convert any CLI with --help support into a Claude Code plugin: one skill per command group plus optional LLM-proposed workflow meta-skills. | | fakoli-crew | Summon nine expert agent archetypes — polyglot architect, Staff-Engineer code reviewer, security auditor, API researcher, plugin engineer, integration specialist, documentation writer, infrastructure keeper, and QA validator — that work independently or as coordinated crews using wave-based orchestration with hook-enforced review gates. | | fakoli-flow | Intent-driven workflow orchestration — brainstorm, plan, and execute complex projects through coordinated specialist agents with a five-stage pipeline (brainstorm → plan → execute → verify → finish), critic gates, and evidence-based verification. Works best alongside fakoli-crew. | | fakoli-state | Local-first, runtime-neutral project state engine for humans and AI coding agents. Turn PRDs into lockable, evidence-backed work packets; coordinate multiple agents without conflicts. Event-sourced JSONL source of truth with a rebuildable SQLite projection, lease-based claims, evidence-gated completion, score-driven task expansion, and bidirectional GitHub Issues sync. | | marketplace-manager | Create and manage plugins without leaving Claude Code — scaffold new plugins from template with /add-plugin, validate manifests, regenerate registry indices, and install GitHub Actions workflows. The tool that maintains this marketplace. | | fakoli-style | Governed ledger of the Fakoli operating-model principles — tracks proven, asserted, and aspirational lifecycle statuses and generates a Markdown report from a single canonical source. | | fakoli-plugin-critic | Five specialist critic agents for Claude Code plugin development — agent-critic (frontmatter/color/tools), skill-critic (lazy-loading/no-fuzzy-detection), hook-critic (contract-aware/${CLAUDE_PLUGIN_ROOT}), mcp-critic (schema/actor-validation), structure-critic (manifest/CHANGELOG/version-sync). Audit any plugin with MUST FIX / SHOULD FIX / CONSIDER / NIT verdicts. |

---

Quick Start Examples

# Search your Gmail inbox
/triage

# Generate a hero banner for your README
/generate-image "Hero banner with bold headline 'Ship Faster' on dark gradient" --aspect 16:9 --size 2K

# Fetch a webpage without prompt-injection risk
/fetch https://docs.anthropic.com/en/docs/about-claude/models/overview

# Create an architecture diagram from your codebase
/excalidraw Diagram the architecture of this project

# Read the last Claude response aloud (defaults to OpenAI TTS)
/speak

# Switch TTS provider
/provider deepgram

# Scaffold a new plugin
/add-plugin my-new-plugin

# Turn a PRD into claimable, evidence-backed work packets
fakoli-state init --name "My Project"
# (author .fakoli-state/prd.md by hand — see plugins/fakoli-state/docs/prd-template.md)
fakoli-state prd parse                                # PRD → requirements + tasks
fakoli-state prd review                               # gate: draft → reviewed
fakoli-state prd review --approve                     # gate: reviewed → approved
fakoli-state plan && fakoli-state score && fakoli-state review tasks   # generate + score + ready
fakoli-state claim T001                               # lockable claim with lease + heartbeat
fakoli-state submit T001 \
  --commands "pytest" --files-changed src/foo.py      # record evidence (gate input)
fakoli-state apply T001 --approve                     # promote to done with audit trail

---

For Plugin Authors

Create Your First Plugin in 5 Steps

1. Scaffold from template

   cp -r templates/basic plugins/your-plugin-name

2. Fill in the manifest — edit .claude-plugin/plugin.json with your plugin's name, version, description, and declared capabilities.

3. Build your capabilities — add skills in skills/, slash commands in commands/, agents in agents/, or hooks in hooks/.

4. Validate locally before pushing

   ./scripts/validate.sh plugins/your-plugin-name

5. Submit a pull request — the CI pipeline will validate your plugin automatically. See the Contributing Guide for review criteria.

Plugin Structure

your-plugin/
├── .claude-plugin/
│   └── plugin.json          # Plugin manifest (required)
├── skills/                  # Skill context files
│   └── skill-name/
│       └── SKILL.md
├── commands/                # Slash command definitions
│   └── command-name.md
├── agents/                  # Sub-agent configurations
│   └── agent-name.md
├── hooks/                   # PreToolUse / PostToolUse hooks
│   └── hook-name.md
├── scripts/                 # Supporting scripts (bash, python, node)
├── README.md                # Plugin documentation (required)
└── LICENSE                  # License file

Validation Pipeline

Every pull request runs three checks:

| Check | What it validates | |-------|-------------------| | validate.yml | Plugin manifest schema, required files, JSON validity | | pr-check.yml | Preview of registry changes on pull requests | | update-index.yml | Auto-regenerates registry/index.json on merge to main |

The schema lives in schemas/plugin.schema.json. Run ./scripts/validate.sh locally to catch errors before pushing.

---

Documentation

| Guide | Description | |-------|-------------| | Contributing Guide | How to safely contribute plugins — review process, security requirements, and merge criteria | | Create Your Own Marketplace | Fork this repo and run your own private or public plugin marketplace | | Plugin Guidelines | Best practices for plugin structure, skill authoring, and command design | | Testing Standards | Requirements for plugin test coverage | | Anthropic Plugin Docs | Official Claude Code plugin documentation from Anthropic |

---

Repository Structure

fakoli-plugins/
├── .claude-plugin/          # Marketplace-level manifest
├── .github/workflows/       # CI: validate, update-index, pr-check, schema-drift
├── plugins/                 # All active plugins (13)
├── archive/                 # Archived / deprecated plugins
├── registry/                # Auto-generated plugin index (do not edit manually)
├── schemas/                 # JSON Schema definitions for manifests
├── scripts/                 # validate.sh, generate-index.sh, and other tools
├── templates/               # Starter templates for new plugins
│   └── basic/               # Standard plugin scaffold
├── assets/                  # Marketplace assets (banner, logos)
└── docs/                    # Guides and documentation

---

Archived Plugins

Some plugins have been archived and are no longer actively maintained. They remain available in the archive/ directory for reference.

---

License

This marketplace is licensed under the MIT License. Individual plugins may have their own licenses — check each plugin's LICENSE file.

---

Built and maintained by <a href="https://github.com/fakoli">@fakoli</a>

Summary

Install to Claude Code