Contribute a workflow example to the gallery #1410

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.