SQUADS

Frequently Asked Questions

Common questions about squads.sh and the AIOS Squad ecosystem.

What is an AIOS Squad?

An AIOS Squad is a self-contained package of AI agents, tasks, workflows, and configuration files designed to work together on a specific domain. Squads follow a standardized format defined by the AIOS framework, making them portable and reusable across projects.

How do I install a squad?

First, install the CLI globally. Then add a squad from the marketplace or a GitHub repository. See the CLI Reference for all available options.

npm install -g @squads-sh/cli
squads add user/squad-name

How do I publish my squad?

Authenticate with squads login, ensure your squad has a valid squad.yaml with name, version, and description, then run squads publish from your squad directory. Your squad will undergo an automated security audit.

squads login
squads publish

Is it free?

Yes. squads.sh is free to use for both installing and publishing squads. Searching, browsing, and downloading squads has no cost. Publishers can optionally set up paid squads through the marketplace, but the platform itself is free. The CLI is open source.

How does gamification work?

  • ▸XP — Earn experience points for publishing squads, receiving installs, getting reviews, and contributing updates.
  • ▸Levels — Progress through levels (Rookie, Builder, Architect, Master) as you accumulate XP.
  • ▸Badges — Unlock achievement badges for milestones (First Publish, 100 Installs, Top Rated, etc.).
  • ▸Leaderboards — Compete on weekly and all-time rankings visible on the Trending and Hot pages.

How are security audits done?

Every squad published to the marketplace undergoes an automated security audit that checks for:

  • ▸Structural validity — correct file format, required fields, valid YAML/Markdown
  • ▸Cross-reference integrity — all agents referenced in tasks and workflows exist
  • ▸Prompt injection patterns — detection of potentially malicious instructions in agent definitions
  • ▸Sensitive data exposure — scanning for hardcoded secrets, API keys, or credentials

Audit results are publicly visible on the Audits page. Squads are rated as SAFE, WARNING, or CRITICAL.

Can I sell my squads?

Yes. The marketplace supports paid squads. When publishing, you can set a price for your squad. Payments are processed through Stripe, and you receive payouts directly to your connected account. Free squads remain the default and are encouraged for community growth.

FAQ — SQUADS