SQUADS

Frequently Asked Questions

Common questions about squads.sh and the squad ecosystem.

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.

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

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

faq.q8

faq.a8

npx aios-core init

faq.q9

faq.a9install

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

faq.a9result

faq.a9ides

FAQ — SQUADS