team-lead

Coordinates peer Claude Code sessions across managed projects via claude-hive messaging.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing multiple independent Claude Code sessions across different projects requires constant manual context-shuffling, status checking, and delegation. This Skill turns one session into a cross-project team lead that discovers peers, delegates goals, tracks outcomes, and escalates blockers without micromanaging each repo. ## Core Features & Use Cases - Peer discovery and messaging: Uses the claude-hive MCP broker (list_peers, send_message, set_summary) to find active sessions and delegate work via stable_ids that survive restarts. - Goal-level delegation: Delegates in problem space (goals, deadlines, success criteria) rather than solution space, letting each peer apply its own local context. - Cross-project tracking and escalation: Maintains a written plan, tracks goals and blockers across peers, and surfaces human-only steps and decisions to the user. - Use Case: You run six side projects, each with its own Claude Code session. The team-lead session checks each peer's summary, delegates the week's goals, notices one peer is blocked on an OAuth flow only you can complete, and nudges you at the right moment. ## Quick Start Ask the team lead to list active peers and delegate this week's goals from the plan to each project session.

Frequently Asked Questions about team-lead

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

FAQPage Schema
How do I coordinate multiple Claude Code sessions across projects?▼

Run one session as a team lead connected to peers through the claude-hive MCP broker. Use list_peers to discover active sessions, then delegate goals with send_message, referencing peers by their stable_id so messaging survives session restarts.

How should I delegate tasks to another AI coding agent?▼

Delegate in problem space: state the goal, deadline, and success criteria rather than specific files or commands. The receiving session has local context you lack, so over-specifying tactics overrides its knowledge and can silently bypass work already in progress.

What is the difference between session_id and stable_id in claude-hive?▼

A session_id rotates on every restart and breaks message continuity, while a stable_id is derived from sha256 of the git root or working directory and persists across restarts. Always delegate using stable_ids so messages reach the right workspace mailbox.

Can the team lead edit files in other project repositories?▼

No. The team lead never edits other project repos directly; it proposes changes through GitHub PRs and delegates implementation to that project's peer session. Before reading from a project it runs git pull --ff-only to ensure freshness.

When should a peer's pushback override a delegation?▼

Almost always. A peer refusing a delegation with concrete concerns usually has session-local context about user criteria, repo conventions, or prior decisions. The team lead should listen, flag the conflict to the user, and avoid re-explaining or overriding.