Contribute a workflow example to the gallery

Contribute a workflow example

The community examples gallery showcases reusable Astron Agent workflows that anyone can import and adapt. Adding one is a great first contribution — and you'll show up as a project contributor.

What you need

• A workflow you've built in Astron Agent that does something useful
• Its exported DSL (workflow.yml)

Steps

1. Copy the template: cp -r examples/TEMPLATE examples/<your-example-id>
2. Drop in your exported workflow.yml.
3. Fill in README.md (frontmatter + description) — see examples/README.md for the field list.
4. Scrub secrets ⚠️ — exported DSL can embed API keys / app ids / tokens. Replace them with YOUR_* placeholders. (CI checks this automatically.)
5. Open a PR. The Examples Lint check validates your frontmatter and scans for secrets.

Prefer a guided submission without using Git? Use the ** Submit a Workflow Example** issue form instead.

Not sure what to build? Browse the existing examples for inspiration — translators, summarizers, content generators, Q&A assistants all welcome.