fb-claude-skills

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

Module	Description
heylook-monitor	MCP App dashboard for heylookitsanllm local LLM server
skill-dashboard	ext-apps MCP App quality dashboard (TypeScript)

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: