Editor support

Actio ships a JSON Schema for .actio.yml, so the YAML extension (which bundles yaml-language-server) gives you autocomplete, hover docs, and validation for the macro keywords — no custom language server required.

The schema inherits the full official GitHub Actions workflow schema (vendored from SchemaStore) and layers the Actio macros on top, so you get complete Actions validation plus the macro keywords — nothing from regular Actions is missing. The only hand-maintained piece is actio.extensions.json; run npm run schema:build -w actio-core to regenerate, or npm run schema:refresh -w actio-core to pull the latest upstream Actions schema first.

Modeline

Add this modeline to the top of any .actio.yml file (actio init adds it for you):

# yaml-language-server: $schema=https://raw.githubusercontent.com/austenstone/actio/main/packages/core/schema/actio.schema.json

Prefer a pinned local copy? Write one and point the modeline at it:

actio schema --out .actio.schema.json
# then: # yaml-language-server: $schema=./.actio.schema.json

The schema is also exported from actio-core (actioSchema(), actioSchemaPath, ACTIO_SCHEMA_URL, SCHEMA_MODELINE).