setup

Configures a fresh ai-team-lead clone with git hooks, registry, dependencies, and claude-hive messaging.

Updated May 12, 2026
One-click install
npx skills add https://github.com/fryanpan/ai-team-lead --skill setup-fryanpan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: setup
Source: https://github.com/fryanpan/ai-team-lead/tree/main/.claude/skills/setup
Command: npx skills add https://github.com/fryanpan/ai-team-lead --skill setup-fryanpan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? A fresh clone of the ai-team-lead repository is not immediately usable: git hooks are disabled, the project registry is missing, system dependencies may be absent, and the claude-hive inter-agent messaging layer is not installed. This Skill walks you through the entire first-time setup in a guided, step-by-step flow so the multi-agent team-lead workflow works correctly from the start. ## Core Features & Use Cases - Repository Bootstrapping: Enables git hooks (pre-push leak gate and worktree symlink setup) and seeds registry.yaml from the example template so you can register your projects. - Dependency Verification & Installation: Checks for tmux, gh, uv, and bun, then installs Python dependencies via uv sync. - claude-hive Registration: Installs and registers the required claude-hive MCP server for inter-agent messaging, including user-scope tool permissions and multi-user port configuration on shared machines. - Optional Channel Setup: Walks through Discord bot access, Notion page watching for /weekly-plan, and GitHub event notifications. - Use Case: After cloning the repo on a new machine, run this Skill once to get hooks, registry, dependencies, and hive messaging configured, then immediately start using /add-project, /daily-review, or /weekly-plan. ## Quick Start Ask Claude to run first-time setup for this freshly cloned ai-team-lead repository and follow the guided prompts.

Frequently Asked Questions about setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up the ai-team-lead repo after cloning?▼

Run the setup skill once after cloning. It enables git hooks, seeds registry.yaml from the example template, verifies tmux, gh, uv, and bun, installs Python dependencies with uv sync, and registers the required claude-hive MCP server.

How do I install and register claude-hive for Claude Code?▼

Clone the claude-hive-mcp repository, run bun install, then register it with claude mcp add using stdio transport. You also need to allow the five hive tools in your user-scope settings.json so they work across all projects.

Why does claude-hive only work in one project?▼

The common cause is granting hive tool permissions at project scope instead of user scope. A project-level grant in .claude/settings.json only covers that repo; add the five mcp__claude-hive tools to your user ~/.claude/settings.json allowlist instead.

Can multiple OS users run claude-hive on the same machine?▼

Yes, but each additional OS user must set a unique CLAUDE_HIVE_PORT environment variable because the broker binds a machine-wide default port of 7900. Without this, the second user's sessions silently join the first user's hive.

What dependencies does the ai-team-lead setup require?▼

The setup checks for tmux, gh, uv, and bun at the OS level, then runs uv sync for Python dependencies. Claude Code v2.1.80 or later is required for claude-hive, and Discord, Notion, and GitHub channel setups are optional.

Should I run the setup skill more than once?▼

No. The skill is idempotent by design: if registry.yaml exists, core.hooksPath is already .githooks, and claude mcp list shows claude-hive, it reports that setup is complete and exits without changes.