personal-squad

Configures user-level AI agents that persist across projects via a global squad directory.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/codebytes/btt --skill personal-squad-codebytes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: personal-squad
Source: https://github.com/codebytes/btt/tree/main/.squad/templates/skills/personal-squad
Command: npx skills add https://github.com/codebytes/btt --skill personal-squad-codebytes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Project-scoped AI agents disappear when you switch repositories, forcing you to redefine the same assistant personas in every project. This Skill defines a personal squad of user-level agents that live in your global config directory and are automatically merged into any squad session. ## Core Features & Use Cases - Ambient Discovery: Personal agents stored in ~/.config/squad/personal-squad (or %APPDATA% on Windows) are automatically detected and merged into the session cast alongside project agents. - Ghost Protocol: Personal agents can read project state and advise, but cannot write to project .squad/ state, keeping project ownership clear. - Lifecycle Commands: Bootstrap, list, add, and remove personal agents with squad personal init/list/add/remove, and inspect the combined cast with squad cast. - Use Case: A developer who wants the same code-reviewer agent available in every repository creates it once as a personal agent, and it appears in every squad session without per-project setup. ## Quick Start Initialize my personal squad and add a personal agent named reviewer with the code-review role so it joins all my squad sessions.

Frequently Asked Questions about personal-squad

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

FAQPage Schema
How do I create AI agents that work across multiple projects?

Create a personal squad by running squad personal init, then add agents with squad personal add {name} --role {role}. These agents live in your global config directory and are automatically merged into every squad session alongside project agents.

Where are personal squad agents stored?

Personal agents are stored in ~/.config/squad/personal-squad/ on Linux and macOS, or %APPDATA%/squad/personal-squad/ on Windows. Each agent has its own subdirectory containing a charter.md and history.md file.

Can personal agents modify project state?

No. Personal agents operate under the Ghost Protocol: they can read project state and advise, but cannot write to the project's .squad/ directory. Project agents execute changes and take precedence on conflicts.

How do I disable personal squad discovery?

Set the SQUAD_NO_PERSONAL environment variable to any value to disable ambient discovery of personal agents. You can also override the default directory location with SQUAD_PERSONAL_DIR.

What is the difference between personal agents and project agents?

Project agents are defined in a project's .squad/ directory and can read and write project state. Personal agents travel with the user across projects, are read-only under the Ghost Protocol, and yield to project agents on conflicts.