architectural-proposals
github/squad/packages/squad-cli/templates/skills/architectural-proposals/SKILL.md
How to write comprehensive architectural proposals that drive alignment before code is written
One search for your own team's files and the public ecosystem. See how real projects write their agent instructions, and bring the good ideas home.
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
github/squad/packages/squad-cli/templates/skills/architectural-proposals/SKILL.md
How to write comprehensive architectural proposals that drive alignment before code is written
github/squad/packages/squad-cli/templates/skills/ci-validation-gates/SKILL.md
Defensive CI/CD patterns: semver validation, token checks, retry logic, and draft detection
github/squad/packages/squad-cli/templates/skills/coordinator-init-mode/SKILL.md
The complete two-phase Init Mode protocol the Squad coordinator runs when no team exists yet in the current repo. Phase 1 = propose the team (no files created, wait for user confirm). Phase 2 = create .squad/ scaffolding, casting state, .gitattributes for merge drivers, and the always-on built-ins (Scribe, Ralph, Rai, Fact Checker). Loaded on demand when the coordinator detects no .squad/team.md exists.
github/squad/packages/squad-cli/templates/skills/coordinator-response-mode/SKILL.md
Selecting WHO handles work is the Routing table; selecting HOW they handle it (Direct, Lightweight, Standard, Full) is Response Mode. This skill contains the complete decision table, exemplar prompts for each mode, the Lightweight spawn template, and the upgrade rules. Squad coordinator loads this on demand once routing has identified the agent — to pick the right ceremony level for the task.
github/squad/packages/squad-cli/templates/skills/coordinator-source-of-truth/SKILL.md
The complete file-by-file source-of-truth hierarchy for Squad: which files are authoritative, which are derived/append-only, who may write each one, who may read each one, and the precedence rules when they conflict. Squad coordinator loads this on demand when it needs to resolve a write conflict, decide where a piece of state belongs, or answer a 'who owns this file' question.
github/squad/packages/squad-cli/templates/skills/cross-machine-coordination/SKILL.md
Design proposal, not implemented: git-based task queuing between squad machines. For competing watchers, use squad watch work claims (ADR-002).
github/squad/packages/squad-cli/templates/skills/cross-squad-communication/SKILL.md
Protocol for sending queries, delegating tasks, and sharing context between independent Squad instances across different repositories
github/squad/packages/squad-cli/templates/skills/docs-standards/SKILL.md
Microsoft Style Guide + Squad-specific documentation patterns
github/squad/packages/squad-cli/templates/skills/e2e-template-testing/SKILL.md
End-to-end validation of coordinator and agent template changes
github/squad/packages/squad-cli/templates/skills/economy-mode/SKILL.md
Shifts Layer 3 model selection to cost-optimized alternatives when economy mode is active.
github/squad/packages/squad-cli/templates/skills/external-comms/SKILL.md
Workflow for scanning, drafting, and presenting community responses with a human review gate
github/squad/packages/squad-cli/templates/skills/gh-auth-isolation/SKILL.md
Safely manage multiple GitHub identities (EMU + personal) in agent workflows
github/squad/packages/squad-cli/templates/skills/gh-aw-enlistment/SKILL.md
Enlist a repository into Squad by installing the supported GitHub Agentic Workflows (gh-aw) bootstrap — with strict compilation, an explicit safe-update allowlist, and a human-reviewed bootstrap PR. Never auto-merges.
github/squad/packages/squad-cli/templates/skills/git-workflow/SKILL.md
Squad branching model: dev-first workflow with insiders preview channel
Often used withsquad-commandsci-cd-pipelines
github/squad/packages/squad-cli/templates/skills/history-hygiene/SKILL.md
Record reconciled final outcomes to history.md, not intermediate requests or obsolete claims
github/squad/packages/squad-cli/templates/skills/humanizer/SKILL.md
Tone enforcement patterns for external-facing community responses
github/squad/packages/squad-cli/templates/skills/model-selection/SKILL.md
Determines which LLM model to use for each agent spawn
github/squad/packages/squad-cli/templates/skills/notification-routing/SKILL.md
Route agent notifications to specific channels by type — prevent alert fatigue from single-channel flooding
github/squad/packages/squad-cli/templates/skills/pr-review-response/SKILL.md
Teaches agents to reply to PR review comment threads after fixing issues, making resolutions traceable
github/squad/packages/squad-cli/templates/skills/release-process/SKILL.md
Prepare, publish, recover, and verify Squad insider, preview, and stable releases
Plain text files in a repository that tell a coding agent how the project works: commands to run, conventions to follow and things to avoid. CLAUDE.md, AGENTS.md, cursor rules and skills are the common kinds.
CLAUDE.md is read by Claude Code. AGENTS.md is an open format that Codex, Cursor and other agents read. Many projects keep one and point the other at it.
A folder with a SKILL.md that describes one capability, such as filling PDFs or reviewing code. The agent loads it only when the task calls for it.
Your agents already can, over MCP, limited to the files you're allowed to read. Searching them from this page is coming.