deepflow-labs-tools

deepflow-labs-tools
The single setup point for Claude Code at DeepFlow Labs

Run the setup script once and get everything you need for Claude Code across all DeepFlow Labs repositories — team skills, MCP servers (Linear, Clerk, Convex, Vercel, Playwright), and recommended official plugins.

You don't need to configure Claude Code in each repo. This is the one place where it all gets set up.

Table of Contents

• Why This Exists
• Quick Setup
• What You Get
• Roadmap — Skills We're Building
• Using Skills Effectively
• MCP Servers
• How It Works Across Repos
• Contributing
• Creating & Updating Skills
• Testing Locally
• Versioning & Updates
• Plugin Structure
• Troubleshooting

🧭 Why This Exists

We all do the same operational tasks repeatedly — writing PRDs, filing bugs in Linear, creating GitHub issues, reviewing PRs, scaffolding features. Each person does them slightly differently, and the quality varies.

This repo fixes that by turning those repeatable processes into shared, versioned skills that Claude Code executes consistently. Think of it as runbooks for AI — instead of a wiki page describing how to write a good bug report, we encode that process as a skill that Claude follows step by step, every time.

The goals are simple:

1. Standardize — Everyone follows the same process for creating bugs, PRDs, epics, and other operational artifacts
2. Elevate quality — Skills enforce structure, required fields, and review steps that are easy to skip manually
3. Save time — Instead of context-switching to Linear/GitHub and filling out templates, describe what you need and let Claude handle the formatting and creation
4. Share knowledge — When someone figures out a better workflow, they encode it as a skill and the whole team benefits

The rule of thumb: if you find yourself doing something repeatable in Linear, GitHub, or any other tool — it should probably be a skill in this repo.

🚀 Quick Setup

One-time setup — run once, productive everywhere. After this, every claude session in any DeepFlow Labs repo has access to team skills, MCP servers, and all recommended plugins.

Option A: Setup script (recommended)

curl -fsSL https://raw.githubusercontent.com/deepflow-labs/ai-skills/main/setup.sh | bash

Or clone and run locally:

git clone git@github.com:deepflow-labs/ai-skills.git
cd ai-skills
./setup.sh

The script installs everything: marketplace, team plugin, and all 10 official plugins. It's idempotent — safe to run again if you want to check for missing plugins.

Option B: Manual setup

If you prefer to install things individually:

claude plugin marketplace add deepflow-labs/ai-skills
claude plugin install deepflow-labs-tools@deepflow-labs-tools

# Service integrations
claude plugin install github@claude-plugins-official          # GitHub PRs, issues, code search

# Development workflows
claude plugin install commit-commands@claude-plugins-official # Git commit, push, PR
claude plugin install pr-review-toolkit@claude-plugins-official # PR review agents
claude plugin install code-review@claude-plugins-official     # Code review
claude plugin install code-simplifier@claude-plugins-official # Code simplification
claude plugin install feature-dev@claude-plugins-official     # Guided feature development
claude plugin install skill-creator@claude-plugins-official   # Create & review skills
claude plugin install hookify@claude-plugins-official         # Create hooks from conversation

# Output style (optional)
claude plugin install explanatory-output-style@claude-plugins-official  # Educational insights