Agent Skills
› microsoft/Generative-AI-for-beginners-dotnet
› personal-squad
personal-squad
GitHub管理跨项目用户级AI智能体集合，支持自动发现、合并及权限隔离（Ghost Protocol），提供初始化、增删查等CLI命令。
Trigger Scenarios
创建个人AI智能体配置
管理跨项目共享的AI助手
Install
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill personal-squad -g -y
SKILL.md
Frontmatter
{
"name": "personal-squad",
"domain": "configuration",
"source": "manual",
"confidence": "medium",
"description": "User-level AI agents that travel with you across projects"
}
Personal Squad — Skill Document
What is a Personal Squad?
A personal squad is a user-level collection of AI agents that travel with you across projects. Unlike project agents (defined in a project's .squad/ directory), personal agents live in your global config directory and are automatically discovered when you start a squad session.
Directory Structure
~/Library/Application Support/squad/personal-squad/ # macOS
~/.config/squad/personal-squad/ # Linux
%APPDATA%/squad/personal-squad/ # Windows
├── agents/
│ ├── {agent-name}/
│ │ ├── charter.md
│ │ └── history.md
│ └── ...
└── config.json # Optional: personal squad config
How It Works
- Ambient Discovery: When Squad starts a session, it checks for a personal squad directory
- Merge: Personal agents are merged into the session cast alongside project agents
- Ghost Protocol: Personal agents can read project state but not write to it
- Kill Switch: Set
SQUAD_NO_PERSONAL=1to disable ambient discovery
Commands
squad personal init— Bootstrap a personal squad directorysquad personal list— List your personal agentssquad personal add {name} --role {role}— Add a personal agentsquad personal remove {name}— Remove a personal agentsquad cast— Show the current session cast (project + personal)
Ghost Protocol
See templates/ghost-protocol.md for the full rules. Key points:
- Personal agents advise; project agents execute
- No writes to project
.squad/state - Transparent origin tagging in logs
- Project agents take precedence on conflicts
Configuration
Optional config.json in the personal squad directory:
{
"defaultModel": "auto",
"ghostProtocol": true,
"agents": {}
}
Environment Variables
SQUAD_NO_PERSONAL— Set to any value to disable personal squad discoverySQUAD_PERSONAL_DIR— Override the default personal squad directory path
Version History
- bd4e082 Current 2026-08-20 14:06
