last updated: 2026-03-31
fb-claude-skills
Design Principles (VISION.md) -- Skills are retrieval, and retrieval serves an architecture. High precision is the constraint, high recall is the goal. Read this first.
A collection of Claude Code plugins, skills, and MCP Apps. Installable as a plugin marketplace in Claude Code, Cowork, and Claude Desktop.
plugins
Each plugin addresses a different layer of building with AI: planning and decomposition (mece-decomposer), tool environment infrastructure (env-forge), interactive UIs (mcp-apps), development workflows (dev-conventions, tui-design, cogapp-markdown, dimensional-modeling), and plugin management (plugin-toolkit).
| Plugin | Type | Description |
|---|
| mece-decomposer | Hook + Skills + MCP App | MECE decomposition of goals and workflows into Agent SDK-ready components, with interactive tree visualizer. Hook detects Agent SDK imports. |
| mcp-apps | Skills | Build and migrate MCP Apps (interactive UIs for MCP-enabled hosts) |
| plugin-toolkit | Skills + Agents | Analyze, polish, and manage Claude Code plugins |
| tui-design | Hook + Skill | Terminal UI design principles for Rich, Questionary, and Click. Hook detects TUI library imports. |
| cogapp-markdown | Skill | Auto-generate markdown sections using cogapp |
| dev-conventions | Hook + Skills | Auto-detects Python/JS projects at session start, injects uv/orjson/bun/TDD/doc conventions via composable directive files |
| dimensional-modeling | Hook + Skill | Kimball-style dimensional modeling for DuckDB star schemas. Hook detects DuckDB usage. |
| env-forge | Hook + Skill + Scripts | Interface for Snowflake AWM synthesis pipeline. Hook detects .env-forge or fastapi-mcp. |
| readwise-reader | MCP Server | Search, save, and surface your Readwise Reader library via MCP with OAuth, DuckDB, and full-text search |
| json-query | Skill | JSON query tool selection and syntax -- jg (jsongrep) for extraction, jq for transformation |
| skill-maintainer | Skills | Maintenance tools for skill repos: quality checks, freshness, upstream detection, best practices review |
| skill-dashboard | MCP App | Interactive quality dashboard: checks, token budgets, freshness, version alignment |
project-scoped
installable as a package (not a Claude plugin)
| Module | Description |
|---|
| skill-maintainer | skill-maintain CLI for validating, monitoring, and maintaining skill repos. Git-installable into any repo. |
| agent-state | agent-state CLI for DuckDB audit/state tracking of pipeline, agent, and CLI runs. Watermark history, run trees, skill version lineage with routing metadata and lifecycle management. |
installation
from GitHub (recommended)
# Add the marketplace (once)
/plugin marketplace add fblissjr/fb-claude-skills
# Install individual plugins
/plugin install mece-decomposer@fb-claude-skills
/plugin install mcp-apps@fb-claude-skills
/plugin install plugin-toolkit@fb-claude-skills
/plugin install tui-design@fb-claude-skills
/plugin install cogapp-markdown@fb-claude-skills
/plugin install dimensional-modeling@fb-claude-skills
/plugin install dev-conventions@fb-claude-skills
/plugin install env-forge@fb-claude-skills
/plugin install skill-maintainer@fb-claude-skills
/plugin install json-query@fb-claude-skills
Or from the terminal:
claude plugin marketplace add fblissjr/fb-claude-skills
claude plugin install mece-decomposer@fb-claude-skills
from local clone
git clone https://github.com/fblissjr/fb-claude-skills.git
cd fb-claude-skills
/plugin marketplace add .
/plugin install mece-decomposer@fb-claude-skills
temporary loading (development)
claude --plugin-dir ./apps/mece-decomposer
uninstall
claude plugin uninstall mece-decomposer@fb-claude-skills
claude plugin list # verify
where things work
New to MCP? See docs/mcp-ecosystem.md for a field guide to the full MCP ecosystem -- protocols, transports, tools, apps, connectors, and how they all relate.
Plugins from this repo work across multiple Claude surfaces, but capabilities differ by surface:
