agent-collaboration

Standardize squad agent collaboration with worktree awareness and decision logging.

413|64|Updated Feb 7, 2023
One-click install
npx skills add https://github.com/christianhelle/refitter --skill agent-collaboration-christianhelle
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-collaboration
Source: https://github.com/christianhelle/refitter/tree/main/.copilot/skills/agent-collaboration
Command: npx skills add https://github.com/christianhelle/refitter --skill agent-collaboration-christianhelle

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Standardizes collaboration patterns for squad agents to ensure worktree awareness, consistent decision logging, and clear cross-agent communication across the team.

Core Features & Use Cases

  • Worktree Awareness: Agents use the TEAM ROOT path provided in the spawn prompt; never assume CWD is the repo root.
  • Decision Recording: After making a decision affecting others, write it to .squad/decisions/inbox/{your-name}-{brief-slug}.md with the date, author, and rationale.
  • Cross-Agent Communication: If input from teammates is needed, request it through the coordinator rather than working in isolation.
  • Anti-Patterns: Do not read unrelated charters; avoid modifying others' history.md; do not bypass the spawn prompts.

Quick Start

Follow the standard collaboration patterns to coordinate work, record decisions, and request input from teammates through the coordinator.

Frequently Asked Questions about agent-collaboration

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

FAQPage Schema
How do I standardize cross-agent communication for a squad workflow?

To standardize cross-agent communication, codify worktree awareness, decision logging, and inbox-based messaging into a reusable spawn prompt pattern. This ensures squad agents coordinate input through a coordinator rather than working in isolation.

What is the standard format for agent decision logging in a team workspace?

Agent decision logging requires writing a markdown file to `.squad/decisions/inbox/{your-name}-{brief-slug}.md`. This file must include the decision date, author, and rationale to inform teammates of changes affecting their work.

How do I ensure agents maintain worktree awareness when spawned?

Worktree awareness is maintained by requiring agents to use the TEAM ROOT path provided in the spawn prompt. Agents must never assume the current working directory is the repository root to prevent file path errors.

Can I use the inbox pattern to request input from teammate agents directly?

No, you should request input through the coordinator instead of direct messaging. The inbox pattern is used for recording decisions, while the coordinator manages coordinated input from teammates to prevent isolation.

What are the anti-patterns to avoid during agent collaboration?

Agent collaboration anti-patterns include reading unrelated charters, modifying others' history.md files, and bypassing spawn prompts. Agents should strictly follow the standardized collaboration patterns to maintain team coordination.

Do I need a valid SKILL.md frontmatter to enable squad-level collaboration?

Yes, a valid SKILL.md frontmatter with name and description is required. This enforces the functional requirements needed to enable consistent decision writing and cross-agent communication across the team.