Personal Squad — Skill Document

Merge persistent personal AI agents into Squad sessions with ghost-protocol safety.

2|Updated Apr 21, 2026
One-click install
npx skills add https://github.com/elbruno/md-to-slides --skill personal-squad-skill-document-elbruno
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Personal Squad — Skill Document
Source: https://github.com/elbruno/md-to-slides/tree/main/.squad/templates/skills/personal-squad
Command: npx skills add https://github.com/elbruno/md-to-slides --skill personal-squad-skill-document-elbruno

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of repeatedly configuring the same AI agents for every project by letting you keep a persistent set of “personal” agents that are automatically discovered and included in new Squad sessions.

Core Features & Use Cases

  • Ambient discovery of personal agents: Personal agents are merged into your session cast alongside project agents at startup, based on your global personal-squad directory.
  • Ghost Protocol safety: Personal agents can read project state but are constrained from writing to the project’s .squad/ state, reducing accidental side effects.
  • Session control and management: You can initialize, list, add, and remove personal agents, and you can disable discovery using an environment variable.

Quick Start

Run squad personal init from your terminal to create your personal-squad directory, then start adding your agents so they appear automatically in future sessions.

Frequently Asked Questions about Personal Squad — Skill Document

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

FAQPage Schema
How do I keep the same AI agents available across multiple project sessions?

You can keep the same AI agents across projects using ambient directory discovery. Personal agents are merged into your session cast automatically at startup, ensuring consistent behavior across repositories without manual configuration.

Can personal agents write to project state when using a squad workflow?

Personal agents cannot write to project state when using ghost-protocol constraints. They can read project state but are restricted from writing to the project's `.squad/` state to prevent accidental side effects across repositories.

How do I initialize and add personal agents for recurring squad sessions?

Run `squad personal init` from your terminal to create your personal-squad directory. You can then add agents so they appear automatically in future sessions, and use commands to list or remove them as needed.

Does environment variable override work for disabling ambient agent discovery?

Yes, environment variable override works for disabling ambient agent discovery. You can control session management and prevent personal agents from being merged into the session cast by setting the appropriate environment variable.

What is the best way to manage persistent AI agent configurations for multi-project workflows?

The best way to manage persistent configurations is using a global personal-squad directory. This stores your user-defined agents and automatically merges them with project agents at startup, maintaining safety boundaries while ensuring consistent behavior.