Telepath Team Skills

This repository contains skills authored by and used within the Telepath team to help us get our daily work done.

Skills

• Tmux Agent Supervisor — Supervise, observe, and unblock coding agents running under tmux, separate processes, or HTTP ports.
• Tmux Agent Triad — Launch an idle supervisor, worker, and reviewer group under tmux.
• Cargo Cult Review Audit — Audit a system for accumulated complexity and produce ranked simplification proposals.
• Cold Reader — Write documents for readers who have no knowledge of the history behind them.
• Complexity Inoculation — Question cascading machinery and keep solutions proportionate to their actual purpose.
• Herdr Agent Supervisor — Supervise coding agents running in Herdr using the supervisr control layer. Requires the Herdr skill, installed separately.
• Herdr Agent Triad — Launch an idle supervisor, worker, and reviewer group inside Herdr.
• Herdr Protocol Alpha — Prepare a Herdr workspace, isolated checkout, and idle agent triad for a development task.
• Logical Merging — Reconcile the policies and assumptions of two branches, not only Git's textual conflicts.
• Plain English — Write clearly without private shorthand, undefined labels, or compressed jargon.
• PR Writing — Describe a pull request's final net change for squash-merge review.
• Tmux Protocol Alpha — Combine the tmux agent triad and a dedicated worktree to prepare for a development task.
• Tmux Start Worktree — Create a dedicated task worktree using the team branch and directory conventions.
• Test Iteration Discipline — Choose focused test commands while iterating and broader validation only when warranted.
• Topical PR Review — Organize a pull request's files and diffs into a hierarchy of logical, thematic changes.