New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Personal Squad

by bradygaster in bradygaster/squad

User-level AI agents that travel with you across projects. An agent skill from bradygaster/squad.

MITAuto-check passed

Install Personal Squad

skills CLI
$ npx skills add bradygaster/squad --skill personal-squad -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install bradygaster/squad personal-squad --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/bradygaster/squad.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.squad-templates/skills/personal-squad .claude/skills/personal-squad && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
personal-squad
GitHub stars
3.3k
Token cost
~544 tokens
SKILL.md length
212 words
Files
1
Skills in repo
31
Repo updated
First seen
Licence
MIT

At a glance

User-level AI agents that travel with you across projects. An agent skill from bradygaster/squad.

  • Works in 4 steps: Ambient Discovery: When Squad starts a… → Merge: Personal agents are merged into… → Ghost Protocol: Personal agents can read… → …
  • SKILL.md covers What is a Personal Squad?, Directory Structure, How It Works and Commands, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Personal Squad is an agent skill from bradygaster/squad. User-level AI agents that travel with you across projects

Its SKILL.md is about 540 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Squad: AI agent teams for any project. The licence is MIT.

Example prompts

  • “/personal-squad”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Ambient Discovery: When Squad starts a session, it checks for a personal squad directory
  2. Merge: Personal agents are merged into the session cast alongside project agents
  3. Ghost Protocol: Personal agents can read project state but not write to it
  4. Kill Switch: Set SQUAD_NO_PERSONAL=1 to disable ambient discovery

What it can do on your machine

Read from SKILL.md and the folder at commit 1fd7e03. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Personal Squad loads about 544 tokens when it runs. Until then it costs about 18 tokens; SKILL.md has 212 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~18
When it runs · the whole SKILL.md, loaded when a task matches
~544

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from bradygaster/squad at commit 1fd7e03, republished under its MIT licence (© bradygaster). 212 words, ~544 tokens.

Download SKILL.mdSave it as .claude/skills/personal-squad/SKILL.md (or your agent's skills folder).
name
personal-squad
description
User-level AI agents that travel with you across projects
domain
configuration
confidence
medium
source
manual

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

  1. Ambient Discovery: When Squad starts a session, it checks for a personal squad directory
  2. Merge: Personal agents are merged into the session cast alongside project agents
  3. Ghost Protocol: Personal agents can read project state but not write to it
  4. Kill Switch: Set SQUAD_NO_PERSONAL=1 to disable ambient discovery

Commands

  • squad personal init — Bootstrap a personal squad directory
  • squad personal list — List your personal agents
  • squad personal add {name} --role {role} — Add a personal agent
  • squad personal remove {name} — Remove a personal agent
  • squad 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:

json
{
  "defaultModel": "auto",
  "ghostProtocol": true,
  "agents": {}
}

Environment Variables

  • SQUAD_NO_PERSONAL — Set to any value to disable personal squad discovery
  • SQUAD_PERSONAL_DIR — Override the default personal squad directory path

© bradygaster, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .squad-templates/skills/personal-squad of bradygaster/squad.

Open the folder on GitHubat commit 1fd7e03

Compare with similar skills

Personal Squad next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Personal Squad compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Personal Squad this skillbradygaster/squad3.3k—~544Automated safety check: PassMIT
Squadsinternet-court/internet-court-skill6.4k2 repos~5.9kAutomated safety check: PassApache-2.0
Agent Squadsickn33/agentic-awesome-skills47k1 repos~1.7kAutomated safety check: WarnMIT
Adding Warehouse Person PropertiesPostHog/posthog40k—~2.9kAutomated safety check: PassCustom licence
Build A Personal Skill From HistoryTHU-MAIC/OpenMAIC40k—~678Automated safety check: PassMIT
Travel Plannersickn33/agentic-awesome-skills47k1 repos~2kAutomated safety check: PassMIT

Similar skills

  • Squads

    internet-court/internet-court-skill

    Complete guide for Squads Protocol - Solana's leading smart account and multisig infrastructure.

    6.4k GitHub starsUsed in 2 repos~5.9k tokens
    Business, Finance & HRAuto-check passed

  • Agent Squad

    sickn33/agentic-awesome-skills

    Main agent orchestrator that coordinates a specialized squad of agents

    47k GitHub starsUsed in 1 repo~1.7k tokens
    Agent WorkflowsAuto-check: warnings

  • Adding Warehouse Person Properties

    PostHog/posthog

    Official

    Sync columns from a synced data warehouse table onto PostHog person or group properties, so warehouse data becomes usable anywhere person and group properties already work: feature flag targeting…

    40k GitHub stars~2.9k tokensUpdated today
    DatabasesAuto-check passed

  • Build A Personal Skill From History

    THU-MAIC/OpenMAIC

    Derives a reusable personal skill for course-making from a representative sample of the user's own past classrooms and chat history, confirmed with them before saving.

    40k GitHub stars~678 tokensUpdated today
    Agent WorkflowsAuto-check passed

  • Travel Planner

    sickn33/agentic-awesome-skills

    旅行/行程规划需求时使用:规划去某地旅行、X天X城、带老人孩子、自驾、假期安排等。产出逐日行程表、预算估算(经济/舒适/奢华三档)、交通住宿建议、景点美食清单。必须先问预算,预算未确认只输出问题清单;事实数据带来源和查询日期。

    47k GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed

  • Personalized Email

    topoteretes/cognee

    Draft a reply to your newest Gmail email that knows what you discussed in your Granola meetings, what you promised the sender, and how you write, using cognee memory.

    32k GitHub stars~695 tokensUpdated yesterday
    Productivity & AutomationAuto-check: notes

More from bradygaster/squad

All 31 skills in this repo

  • Fact Checking

    bradygaster/squad

    Review and validate claims using counter-hypothesis testing.

    3.3k GitHub stars~503 tokensUpdated today
    Auto-check passed

  • Architectural Review

    bradygaster/squad

    How to review PRs for architectural quality — module boundaries, dependency direction, export surface, pattern consistency

    3.3k GitHub stars~2.2k tokensUpdated today
    Auto-check passed

  • Archival Integrity

    bradygaster/squad

    Preserve content when moving entries between tracked Squad state files

    3.3k GitHub stars~735 tokensUpdated today
    Auto-check passed

  • CI Validation Gates

    bradygaster/squad

    Defensive CI/CD patterns: semver validation, token checks, retry logic, and draft detection

    3.3k GitHub stars~1.1k tokensUpdated today
    Auto-check passed

  • CLI Wiring

    bradygaster/squad

    Checklist and patterns for wiring new CLI commands into cli-entry.ts

    3.3k GitHub stars~501 tokensUpdated today
    Auto-check passed

  • Cross Machine Coordination

    bradygaster/squad

    Enables squad agents on different machines to share work via git-based task queuing

    3.3k GitHub stars~2.7k tokensUpdated today
    Auto-check passed

Questions about Personal Squad

What does Personal Squad do?

User-level AI agents that travel with you across projects. An agent skill from bradygaster/squad. Personal Squad is an agent skill from bradygaster/squad.

How do I install Personal Squad in Claude Code?

Run `npx skills add bradygaster/squad --skill personal-squad -a claude-code`. Or copy the skill folder (.squad-templates/skills/personal-squad in bradygaster/squad) into .claude/skills/personal-squad in your project. Claude Code loads it when a task matches its description.

How do I install Personal Squad in Codex?

Run `npx skills add bradygaster/squad --skill personal-squad -a codex`. Or copy the skill folder (.squad-templates/skills/personal-squad in bradygaster/squad) into .agents/skills/personal-squad in your project. Codex loads it when a task matches its description.

Can I use Personal Squad in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add bradygaster/squad --skill personal-squad -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/personal-squad, .gemini/skills/personal-squad, .github/skills/personal-squad and .opencode/skills/personal-squad in your project.

What does Personal Squad need to run?

SKILL.md names no scripts, command-line tools or credentials: Personal Squad is instructions for the agent only.

Does Personal Squad access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Personal Squad safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Personal Squad use?

Personal Squad is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Personal Squad use?

About 544 tokens (SKILL.md is roughly 2.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Personal Squad?

Skills that share tags, products or a category with Personal Squad: Squads (internet-court/internet-court-skill, 6.4k stars), Agent Squad (sickn33/agentic-awesome-skills, 47k stars), Adding Warehouse Person Properties (PostHog/posthog, 40k stars) and Build A Personal Skill From History (THU-MAIC/OpenMAIC, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Personal Squad?

bradygaster (a GitHub user) maintains it in bradygaster/squad, which has 3,257 GitHub stars. The repository holds 31 skills in this directory. The repository was last updated on October 8, 2026.

Source: bradygaster/squad on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.