personal-squad

Merges user-level AI agents from the global config into sessions while preventing writes to project state.

1|Updated Apr 18, 2026
One-click install
npx skills add https://github.com/DeDuva/squad --skill personal-squad-deduva
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: personal-squad
Source: https://github.com/DeDuva/squad/tree/main/.squad/skills/personal-squad
Command: npx skills add https://github.com/DeDuva/squad --skill personal-squad-deduva

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Personal squads provide user-level AI agents that travel with you across projects, preserving context and reducing reconfiguration time between environments.

Core Features & Use Cases

  • Ambient Discovery: Squad searches the global config for personal agents and merges them into the session cast.
  • Isolation and Safety: Personal agents read project state but cannot write to project state, preserving project integrity.
  • Flexible Management: Bootstrap, list, add, and remove personal agents, and view the current cast during a session.

Quick Start

Run squad personal init to bootstrap your personal squad directory.

Frequently Asked Questions about personal-squad

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

FAQPage Schema
How do I maintain AI agent context when switching between projects?

Personal squads provide user-level AI agents that travel across projects to maintain context continuity. They merge into your active session automatically, preserving your configuration without altering project state.

How do I bootstrap personal AI agents to carry across sessions?

To bootstrap personal AI agents, run the squad personal init command to create your personal squad directory. This enables ambient discovery, allowing your agents to automatically merge into the current session cast.

Can personal AI agents write to project state during a session?

Personal AI agents cannot write to project state due to an enforced ghost protocol. This strict isolation ensures personal agents only read project state, preserving the integrity of your current project environment.

How does ambient discovery work for merging personal agents?

Ambient discovery works by searching your global config for personal agents and merging them into the current session cast. This mechanism automatically integrates user-level agents into the active project environment.

Do I need dependencies to manage a personal squad of AI agents?

No external dependencies are required to manage a personal squad. The system independently handles ambient discovery, agent merging, and ghost protocol enforcement using built-in component directories for scripts and references.