personal-squad

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

2|Updated Jul 24, 2026
One-click install
npx skills add https://github.com/elbruno/ElBruno.MagenticUI --skill personal-squad-elbruno
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: personal-squad
Source: https://github.com/elbruno/ElBruno.MagenticUI/tree/main/.squad/templates/skills/personal-squad
Command: npx skills add https://github.com/elbruno/ElBruno.MagenticUI --skill personal-squad-elbruno

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Project-scoped AI agents disappear when you switch repositories, forcing you to redefine the same assistant roles 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 the OS-specific config directory (macOS, Linux, or 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 data under project agents' control. - Lifecycle Commands: Bootstrap, list, add, and remove personal agents with squad personal init, list, add, and remove commands. - Use Case: A developer who wants the same code-reviewer persona available in every repository creates it once with squad personal add reviewer --role code-review, and it appears in every future squad session without per-project setup. ## Quick Start Initialize my personal squad directory and add a personal agent named reviewer with the code-review role.

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?▼

Run `squad personal init` to bootstrap a personal squad directory in your global config folder, then add agents with `squad personal add {name} --role {role}`. These agents are automatically discovered and merged into every squad session.

Where are personal squad agents stored on macOS, Linux, and Windows?▼

Personal agents live in `~/Library/Application Support/squad/personal-squad/` on macOS, `~/.config/squad/personal-squad/` on Linux, and `%APPDATA%/squad/personal-squad/` on Windows. You can override the path with the SQUAD_PERSONAL_DIR environment variable.

Can personal agents modify project files or state?▼

No. The ghost protocol restricts personal agents to read-only access of project state. They advise while project agents execute, and project agents take precedence on conflicts.

How do I disable personal squad discovery temporarily?▼

Set the SQUAD_NO_PERSONAL environment variable to any value before starting a session. This kill switch prevents ambient discovery of personal agents without deleting the personal squad directory.

What is the difference between project agents and personal agents?▼

Project agents are defined in a project's `.squad/` directory and can write project state, while personal agents live in the global config directory, travel across projects, and operate under the read-only ghost protocol.