Swirls Language

Canonical source. The latest version of this skill is always published at https://swirls.ai/.well-known/agent-skills/swirls-lang/SKILL.md, with an integrity digest in https://swirls.ai/.well-known/agent-skills/index.json (Agent Skills Discovery). Rules files resolve relative to that URL. The GitHub copy at ByteSliceHQ/swirls is a mirror; if your copy's version trails the index, prefer the published one.

Comprehensive guide for authoring .swirls workflow files. Covers the full DSL: file structure, workflow declarations (formerly graph), all 16 node types, TypeScript / JSON / SQL embedded blocks, the context object (including context.iteration for map/while), resources, triggers, top-level stream / view / schema / disk / agent / channel / connection blocks, access-control blocks (role / policy; declaring policy grants flips the project to deny-by-default), agent subagent teams, optional agent wallet for Zero tool spend, reviews, failure policies, output format:, and known parser pitfalls.

When to Apply