skills.rest
AhmedElBanna80
AhmedElBanna80COMMUNITY
Explore all skills by this author →
GitHub

superteam:layout

Organize superteam agent panes into flat or by-worktree layouts across tmux and iTerm2.

Updated May 13, 2026
Search Tags:#tmux#iTerm2#cmux#agent team#terminal multiplexer#pane layout#ticket grouping
One-click install
npx skills add https://github.com/AhmedElBanna80/superteam --skill superteam-layout
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: superteam:layout
Source: https://github.com/AhmedElBanna80/superteam/tree/main/skills/layout
Command: npx skills add https://github.com/AhmedElBanna80/superteam --skill superteam-layout

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill solves the chaos of scattered agent panes by automatically arranging superteam teammates into a clear, repeatable visual layout so you can follow planning, implementation, and review work across tickets.

Core Features & Use Cases

  • Flat vs. by-worktree layout: Use flat for no structural regrouping, or by-worktree to group panes that share the same ticket prefix.
  • Pane-title driven grouping: Detects teammate panes by enforcing the <ticket>:<role> pane-title convention for implementer, spec reviewer, and code reviewer.
  • Multiplexer-aware behavior: Reads live pane titles via cmux, tmux, or iTerm2, then applies the appropriate grouping strategy.
  • Config persistence: Uses ~/.claude/superteam/config.json to remember multiplexer and the preferred config.layout, with optional override via the skill argument.

Quick Start

Run superteam:layout by-worktree to group implementer, spec-reviewer, and code-reviewer panes under their shared ticket prefix.

Frequently Asked Questions about superteam:layout

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

FAQPage Schema
How do I organize terminal panes by ticket in tmux or iTerm2?▼

To organize terminal panes by ticket, this skill arranges agent panes into a consistent visual layout by reading pane titles formatted as <ticket>:<role> and grouping them in either flat or by-worktree mode across tmux and iTerm2.

How does pane-title driven grouping work for agent teams?▼

Pane-title driven grouping detects teammate panes by enforcing the <ticket>:<role> naming convention for implementer, spec reviewer, and code reviewer roles, then groups panes that share the same ticket prefix together.

Can I use this terminal layout tool if I run cmux instead of tmux?▼

Yes, you can use this tool with cmux. It reads live pane titles via cmux, tmux, or iTerm2, treating cmux as a native no-op while applying the appropriate grouping strategy to tmux and iTerm2.

What is the difference between flat and by-worktree layout modes?▼

Flat layout applies no structural regrouping to agent panes, while by-worktree layout groups panes that share the same ticket prefix together, making it easier to follow planning, implementation, and review work across tickets.

Does the agent pane layout persist across events like team spawn and retry?▼

Yes, the layout persists across repeated events like after team spawn, ticket creation, retry, and garbage collection. It loads your preferred multiplexer and layout settings from ~/.claude/superteam/config.json.

Can I preview terminal pane grouping changes before applying them?▼

Yes, you can preview changes using the optional dry-run behavior. This validates your requested layout mode and dispatches to the correct layout implementation without modifying your current terminal pane arrangement.

Related Skills

Explore More Software Engineering Skills→
AhmedElBanna80AhmedElBanna80

superteam multiplexer-spawn

Spawn superteam teammates in the correct terminal multiplexer pane.

Community
Intermediate
brainbrewlabsbrainbrewlabs
7

ticket-routing

Route classified support tickets to teams using routing tables and SLA targets.

Official
Intermediate
vessuxvessux
1

subagent-driven-development

Dispatch fresh subagents with isolated context to execute implementation plans.

Community
Advanced
hiromimahiromima

tmux × iTerm2 Integration

Automate tmux session orchestration with iTerm2 dynamic profiles for agent panes.

Community
Advanced