Submit Guide

How to publish squads to the marketplace via the web interface.

Two Ways to Submit

You can submit squads to the marketplace using either a GitHub repository URL or by uploading a ZIP file directly.

Method	Best for	Slug format
GitHub URL	Public repos, easy updates via re-submit	owner/repo/squad-name
ZIP Upload	Private squads, no GitHub repo needed	username/uploads/squad-name

Submit via GitHub URL

1Log in to squads.sh with your GitHub account.
2Go to Dashboard > Submit.
3Select "GitHub URL" and enter your repository in owner/repo format.
4Click "Validate". The system will fetch your squad and run validation.
5Review the validation report. Fix any errors if status is CRITICAL.
6Optionally set a price (toggle Free/Paid, enter USD amount).
7Click "Submit to Marketplace" to publish.

Submit via ZIP Upload

1Log in to squads.sh with your GitHub account.
2Go to Dashboard > Submit and select "Upload .zip".
3Drag and drop your ZIP file or click to browse. Max 50MB, must contain squad.yaml.
4Click "Validate" to run validation on the uploaded squad.
5Review the report, set pricing if desired, and click "Submit to Marketplace".

Setting a Price

Squads are free by default. To sell your squad, toggle to "Paid" after validation and enter a price in USD ($0.99 – $999.99). You must connect your Stripe account in Dashboard > Settings before selling paid squads. You can also change the price later from the My Squads page.

Understanding the Validation Report

After validation, you will see a detailed report with a score from 0 to 100 and a status badge:

SAFEScore >= 80, no errors — Ready to publish.

WARNINGHas warnings but no blocking errors — Can be published, but consider fixing warnings.

CRITICALHas errors or low score — Must fix errors before submitting. The submit button is disabled.

The report shows 6 expandable categories (Manifest, Structure, Agents, Tasks, Workflows, Cross-References) with individual findings you can inspect.

After Submission

▸Your squad undergoes an automated security audit. Results are visible on the Audits page.
▸You earn 50 XP for publishing a new squad.
▸To update a published squad, submit the same GitHub URL or upload a new ZIP. The existing listing will be updated.
▸You can change the price anytime from Dashboard > My Squads.

CLI vs Web

Both methods publish to the same marketplace. Choose based on your workflow:

▸Web — Best for visual validation feedback, first-time publishers, and one-off submissions.
▸CLI (squads publish) — Best for automation, CI/CD pipelines, and frequent publishing. Supports --dry-run and --strict flags.

See the CLI Reference for the publish command. CLI Reference