nika-authoringlisted
Install: claude install-skill supernovae-st/nika-agents
# Authoring Nika workflows
Nika turns repeatable AI work into files: one `.nika.yaml`, four verbs,
audited **before** it runs. You author the file; `nika check` is the
oracle; the human runs it.
## The loop (always)
1. **Start from a template or example**, never from scratch:
`nika examples list` · `nika examples show <slug>` ·
`nika new --from <template> <file>.nika.yaml`
2. **Write the file.** Envelope is always `nika: v1` +
`workflow: <kebab-id>` + `tasks:`. Pick models and builtins from
the embedded catalogs — `nika catalog` (providers · models ·
capabilities · which env var each needs) and `nika catalog --tools` (the
`nika:*` builtins an `invoke` reaches without MCP); before a run,
`nika inspect <file>` shows the anatomy: tasks · waves · the cost
floor.
3. **Check it**: `nika check <file>` (exit 0 = clean · 2 = findings),
then `nika check --native-strict <file>` — it fails on any
`native-first` hint (an `exec:` a builtin covers).
4. **Repair**: `nika check <file> --fix` applies the machine-applicable
renames first (typo'd fields · tools · args · `after:` targets ·
`${{ }}` references — typed did-you-mean only, ambiguity is skipped
with a note, never guessed) and re-audits; repair what remains from
the diagnostics — they name the exact task, reference and fix.
Unknown code? `nika explain NIKA-XXXX`.
5. Repeat 3–4 until clean. **Never hand a file to the human that does
not pass `nika check`** — and pass `--native-strict` t