{"id":51223042,"url":"https://github.com/fakoli/fakoli-plugins","last_synced_at":"2026-07-09T07:00:31.977Z","repository":{"id":335966453,"uuid":"1147595060","full_name":"fakoli/fakoli-plugins","owner":"fakoli","description":"A curated collection of Claude Code plugins for enhanced productivity and development workflows","archived":false,"fork":false,"pushed_at":"2026-07-04T23:51:30.000Z","size":28905,"stargazers_count":4,"open_issues_count":2,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-05T01:13:02.442Z","etag":null,"topics":["ai-tools","anthropic","claude","claude-code","claude-code-plugins","plugin-marketplace"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fakoli.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-02T01:11:36.000Z","updated_at":"2026-07-04T23:51:33.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/fakoli/fakoli-plugins","commit_stats":null,"previous_names":["fakoli/fakoli-plugins"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fakoli/fakoli-plugins","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fakoli%2Ffakoli-plugins","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fakoli%2Ffakoli-plugins/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fakoli%2Ffakoli-plugins/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fakoli%2Ffakoli-plugins/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fakoli","download_url":"https://codeload.github.com/fakoli/fakoli-plugins/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fakoli%2Ffakoli-plugins/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35290235,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-09T02:00:07.329Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-tools","anthropic","claude","claude-code","claude-code-plugins","plugin-marketplace"],"created_at":"2026-06-28T09:00:31.116Z","updated_at":"2026-07-09T07:00:31.968Z","avatar_url":"https://github.com/fakoli.png","language":"Python","funding_links":[],"categories":["Source Catalog"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/fakoli-banner.png\" alt=\"Fakoli Plugins Marketplace\" width=\"100%\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\".github/workflows/validate.yml\"\u003e\u003cimg src=\"https://github.com/fakoli/fakoli-plugins/actions/workflows/validate.yml/badge.svg\" alt=\"CI\"\u003e\u003c/a\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-MIT-blue.svg\" alt=\"MIT License\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/github/stars/fakoli/fakoli-plugins?style=social\" alt=\"GitHub Stars\"\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eFakoli Plugins Marketplace\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\u003cstrong\u003eExtend Claude Code with production-grade plugins.\u003c/strong\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  A curated collection of battle-tested Claude Code plugins — covering Google Workspace automation,\n  AI image generation, text-to-speech, diagram authoring, secure web fetching, and marketplace\n  self-management. The active catalog combines end-user tools, development workflows,\n  durable project state, and CI-validated marketplace practices.\n\u003c/p\u003e\n\n---\n\n## Quick Start\n\nAdd this marketplace to Claude Code with one command:\n\n```\n/plugin marketplace add fakoli/fakoli-plugins\n```\n\nThen install any plugin:\n\n```\n/plugin install gws\n/plugin install safe-fetch\n/plugin install nano-banana-pro\n```\n\n---\n\n## What are Claude Code Plugins?\n\nClaude Code plugins extend the assistant with domain-specific capabilities. A plugin can bundle:\n\n- **Skills** — Reusable context files that teach Claude how to use a tool or follow a workflow\n- **Commands** — Slash commands (e.g. `/send-email`, `/speak`, `/fetch`) that invoke specific behaviors\n- **Agents** — Isolated sub-agents for complex, multi-step operations\n- **Hooks** — PreToolUse / PostToolUse interceptors that modify or guard Claude's actions\n\nPlugins 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.\n\n---\n\n## The Fakoli Ecosystem\n\nFakoli is a coherent plugin marketplace rather than a loose grab bag. It has\nfour layers:\n\n- **Work orchestration** — `fakoli-flow`, `fakoli-crew`, and `fakoli-state`\n  define how work is planned, staffed, claimed, verified, and recorded.\n- **Infrastructure judgment** — `systems-thinking` helps teams examine hidden\n  costs, dependencies, caveats, and risks before committing to large changes.\n- **Plugin production practices** — `marketplace-manager`, `cli-to-plugin`,\n  and `fakoli-plugin-critic` help create, validate, review, and maintain\n  Claude Code plugins with repeatable standards.\n- **Daily operator tools** — plugins such as `gws`, `safe-fetch`,\n  `nano-banana-pro`, `handoff`, `quick-notes`, and `session-retro` cover\n  common productivity, media, safety, continuity, and reflection workflows.\n\nAt the center is the fakoli trinity — three plugins designed to compose, each\nuseful standalone:\n\n| Plugin | Role | What It Does |\n|--------|------|--------------|\n| [**fakoli-flow**](plugins/fakoli-flow) | Workflow orchestration | Intent-driven pipeline: brainstorm → plan → execute → verify → finish. Wave-based dispatch with mandatory critic gates between every code-writing phase |\n| [**fakoli-crew**](plugins/fakoli-crew) | Specialist agents | 9 polyglot agents (TypeScript / Python / Rust) — architect, reviewer, security auditor, researcher, plugin engineer, integration specialist, documenter, infrastructure engineer, QA |\n| [**fakoli-state**](plugins/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 |\n\n**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.\n\nA separate companion plugin, [**systems-thinking**](plugins/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.\n\nInstall any combination — each works standalone. The full marketplace gives you\na path from idea to execution: evaluate the system context, plan work, assign it\nto specialists, capture durable handoffs, run safe tool-enabled workflows, and\nverify plugin changes through a shared repository health gate.\n\nFor prior-art context — what fakoli invented, what it reinvented, and where\nthe moat is — see [docs/POSITIONING.md](docs/POSITIONING.md).\n\n---\n\n## Available Plugins\n\n### Google Workspace \u0026 Productivity\n\n| Plugin | Description |\n|--------|-------------|\n| [**gws**](plugins/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. |\n| [**notebooklm-enhanced**](plugins/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. |\n\n### AI \u0026 Media Generation\n\n| Plugin | Description |\n|--------|-------------|\n| [**nano-banana-pro**](plugins/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. |\n| [**fakoli-speak**](plugins/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`. |\n| [**excalidraw-diagram**](plugins/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. |\n\n### Security \u0026 Web\n\n| Plugin | Description |\n|--------|-------------|\n| [**safe-fetch**](plugins/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. |\n\n### Development \u0026 Workflow\n\n| Plugin | Description |\n|--------|-------------|\n| [**cli-to-plugin**](plugins/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. |\n| [**fakoli-crew**](plugins/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. |\n| [**fakoli-flow**](plugins/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. |\n| [**fakoli-state**](plugins/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. |\n| [**systems-thinking**](plugins/systems-thinking) | Analyze infrastructure decisions through discovery, extraction, and synthesis so hidden costs, dependencies, caveats, and risks are visible before implementation. |\n| [**marketplace-manager**](plugins/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. |\n| [**fakoli-style**](plugins/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. |\n| [**fakoli-plugin-critic**](plugins/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. |\n| [**ship-task**](plugins/ship-task) | The mechanical tail of a one-PR-per-task loop, as a single command. After review passes, `/ship` pushes the branch, opens a PR, waits for CI, squash-merges and deletes the branch, syncs the base, and optionally runs a post-merge step (e.g. `anvil apply`) — keeping the repetitive git/gh/CI/merge dance out of the context window. Makes no review decisions; stops if CI fails. |\n\n### Continuity \u0026 Personal Workflow\n\n| Plugin | Description |\n|--------|-------------|\n| [**handoff**](plugins/handoff) | Store durable cross-session project handoff notes shared across same-remote checkouts. |\n| [**quick-notes**](plugins/quick-notes) | Capture, search, edit, and export dictation-friendly personal notes. |\n| [**session-retro**](plugins/session-retro) | Analyze local Claude Code and Codex session logs into actionable retrospectives. |\n\n---\n\n## Quick Start Examples\n\n```\n# Search your Gmail inbox\n/triage\n\n# Generate a hero banner for your README\n/generate-image \"Hero banner with bold headline 'Ship Faster' on dark gradient\" --aspect 16:9 --size 2K\n\n# Fetch a webpage without prompt-injection risk\n/fetch https://docs.anthropic.com/en/docs/about-claude/models/overview\n\n# Create an architecture diagram from your codebase\n/excalidraw Diagram the architecture of this project\n\n# Read the last Claude response aloud (defaults to OpenAI TTS)\n/speak\n\n# Switch TTS provider\n/provider deepgram\n\n# Scaffold a new plugin\n/add-plugin my-new-plugin\n\n# Turn a PRD into claimable, evidence-backed work packets\nfakoli-state init --name \"My Project\"\n# (author .fakoli-state/prd.md by hand — see plugins/fakoli-state/docs/prd-template.md)\nfakoli-state prd parse                                # PRD → requirements + tasks\nfakoli-state prd review                               # gate: draft → reviewed\nfakoli-state prd review --approve                     # gate: reviewed → approved\nfakoli-state plan \u0026\u0026 fakoli-state score \u0026\u0026 fakoli-state review tasks   # generate + score + ready\nfakoli-state claim T001                               # lockable claim with lease + heartbeat\nfakoli-state submit T001 \\\n  --commands \"pytest\" --files-changed src/foo.py      # record evidence (gate input)\nfakoli-state apply T001 --approve                     # promote to done with audit trail\n```\n\n---\n\n## For Plugin Authors\n\n### Create Your First Plugin in 5 Steps\n\n1. **Scaffold from template**\n   ```bash\n   cp -r templates/basic plugins/your-plugin-name\n   ```\n\n2. **Fill in the manifest** — edit `.claude-plugin/plugin.json` with your plugin's name, version, description, and declared capabilities.\n\n3. **Build your capabilities** — add skills in `skills/`, slash commands in `commands/`, agents in `agents/`, or hooks in `hooks/`.\n\n4. **Run the repository health gate before pushing**\n   ```bash\n   ./scripts/check-all.sh\n   ```\n   This is the same combined command CI runs. It performs marketplace\n   validation, path-resolution and hook-safety checks, affected plugin tests,\n   and the hook validation suite. A zero exit means every step passed; any\n   failed step prints the failing layer and exits non-zero, which also fails CI.\n\n5. **Submit a pull request** — the CI pipeline will validate your plugin automatically. See the [Contributing Guide](docs/CONTRIBUTING.md) for review criteria.\n\n### Plugin Structure\n\n```\nyour-plugin/\n├── .claude-plugin/\n│   └── plugin.json          # Plugin manifest (required)\n├── skills/                  # Skill context files\n│   └── skill-name/\n│       └── SKILL.md\n├── commands/                # Slash command definitions\n│   └── command-name.md\n├── agents/                  # Sub-agent configurations\n│   └── agent-name.md\n├── hooks/                   # PreToolUse / PostToolUse hooks\n│   └── hook-name.md\n├── scripts/                 # Supporting scripts (bash, python, node)\n├── README.md                # Plugin documentation (required)\n└── LICENSE                  # License file\n```\n\n### Validation Pipeline\n\nEvery pull request runs the same combined repository health gate contributors\nshould run locally:\n\n```bash\n./scripts/check-all.sh\n```\n\nThe command runs `scripts/validate.sh`, `scripts/test-path-resolution.sh`,\naffected plugin tests, and the hook validation suite in sequence. It exits `0`\nonly after all checks pass. A non-zero exit stops at the failing layer and fails\nthe CI job.\n\nThe CI workflows also run repository-specific follow-up checks:\n\n| Check | What it validates |\n|-------|-------------------|\n| `validate.yml` | Combined health gate, registry drift, and handoff path resolver |\n| `pr-check.yml` | Combined health gate, registry drift, handoff path resolver, and pull request registry preview |\n| `update-index.yml` | Auto-regenerates `registry/index.json` on merge to main |\n\nThe schema lives in `schemas/plugin.schema.json`. For quick manifest-only\niteration, run `./scripts/validate.sh plugins/your-plugin-name`; before\npushing, run `./scripts/check-all.sh`.\n\n---\n\n## Documentation\n\n| Guide | Description |\n|-------|-------------|\n| [Contributing Guide](docs/CONTRIBUTING.md) | How to safely contribute plugins — review process, security requirements, and merge criteria |\n| [Create Your Own Marketplace](docs/CREATE_MARKETPLACE.md) | Fork this repo and run your own private or public plugin marketplace |\n| [Plugin Guidelines](docs/PLUGIN_GUIDELINES.md) | Best practices for plugin structure, skill authoring, and command design |\n| [Testing Standards](docs/TESTING_STANDARDS.md) | Requirements for plugin test coverage |\n| [Anthropic Plugin Docs](https://docs.anthropic.com/en/docs/claude-code/plugins) | Official Claude Code plugin documentation from Anthropic |\n\n---\n\n## Repository Structure\n\n```\nfakoli-plugins/\n├── .claude-plugin/          # Marketplace-level manifest\n├── .github/workflows/       # CI: validate, update-index, pr-check, schema-drift\n├── plugins/                 # All active plugins (17)\n├── archive/                 # Archived / deprecated plugins\n├── registry/                # Auto-generated plugin index (do not edit manually)\n├── schemas/                 # JSON Schema definitions for manifests\n├── scripts/                 # validate.sh, generate-index.sh, and other tools\n├── templates/               # Starter templates for new plugins\n│   └── basic/               # Standard plugin scaffold\n├── assets/                  # Marketplace assets (banner, logos)\n└── docs/                    # Guides and documentation\n```\n\n---\n\n## Archived Plugins\n\nSome plugins have been archived and are no longer actively maintained. They remain available in the [`archive/`](archive/) directory for reference.\n\n---\n\n## License\n\nThis marketplace is licensed under the [MIT License](LICENSE). Individual plugins may have their own licenses — check each plugin's `LICENSE` file.\n\n---\n\n\u003cp align=\"center\"\u003eBuilt and maintained by \u003ca href=\"https://github.com/fakoli\"\u003e@fakoli\u003c/a\u003e\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffakoli%2Ffakoli-plugins","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffakoli%2Ffakoli-plugins","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffakoli%2Ffakoli-plugins/lists"}