personal-squad

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

1|Updated Jul 7, 2026
One-click install
npx skills add https://github.com/seiggy/maf-copilot-studio-demo --skill personal-squad-seiggy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: personal-squad
Source: https://github.com/seiggy/maf-copilot-studio-demo/tree/main/.squad/templates/skills/personal-squad
Command: npx skills add https://github.com/seiggy/maf-copilot-studio-demo --skill personal-squad-seiggy

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 ~/.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, and remove commands. - 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 role of code reviewer.

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 path, then use squad personal add {name} --role {role} to create agents. They are automatically discovered and merged into every squad session.

Where are personal squad agents stored?

Personal agents live 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. The ghost protocol restricts personal agents to read-only access of project state. They advise while project agents execute, and project agents take precedence when conflicts arise.

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 write project state, while personal agents live in the global config directory, travel across projects, and operate in read-only advisory mode under the ghost protocol.