Ssquads.sh
05FAQ

Frequently Asked Questions

Common questions about squads.sh and the squad ecosystem.

01

What is a Squad?

A 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 making them portable and reusable across projects.

02

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
squads add user/squad-name
03

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
04

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.

05

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.
06

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.

07

Can I sell my squads?

Yes! The marketplace supports paid squads with server-gated distribution. Set a price when publishing with squads publish --price 2990 (for $29.90). You'll need to connect your Stripe account in Dashboard > Settings first. Revenue is split 80% to you and 20% to the platform. Buyers purchase on squads.sh and then install via the CLI. Free squads remain the default and are encouraged for community growth.

08

What is AIOS and how does it integrate?

AIOS is a framework for AI-orchestrated development. When you install a squad in AIOS mode, its agents, tasks, and workflows are wired into your IDE so you can drive them with slash commands instead of copy-pasting prompts.

npx aios-core init
09

How do I activate squads in my IDE?

Install a squad with AIOS activation using `squads add my-squad --aios new` (for a new project) or `--aios existing` (to add it to an existing one).

squads add my-squad --aios new
squads add my-squad --aios existing

After activation, the agents are registered as slash commands following the /SQUADS: pattern.

Supported IDEs: Claude Code (full support), Gemini CLI (high parity), Codex CLI (partial), and Cursor.

FAQ — SQUADS