nika

Authors and validates .nika.yaml DAG workflows with cost audits and tamper-evident run traces.

3.4k|487|Updated Jul 25, 2025
One-click install
npx skills add https://github.com/davepoon/buildwithclaude --skill nika
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nika
Source: https://github.com/davepoon/buildwithclaude/tree/main/plugins/all-skills/skills/nika
Command: npx skills add https://github.com/davepoon/buildwithclaude --skill nika

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires nika.

What problem does it solve?

Repeatable AI tasks often live as ad-hoc prompts with unknown cost, unverified structure, and no audit trail. This Skill captures a repeated task as a checked, budgeted .nika.yaml workflow file that is audited before a single token is spent.

Core Features & Use Cases

  • Workflow authoring from templates: Start from nika examples or nika new --from <template>, then pick models and builtins from the embedded nika catalog and nika tools listings.
  • Pre-run auditing: nika check validates the DAG, prints a cost ceiling or floor before any token is spent, and --native-strict flags exec: tasks that a builtin could replace.
  • Deterministic testing and provenance: nika test replays golden files offline with mock models, and every run writes a hash-chained journal to .nika/traces/ verifiable with nika trace verify.
  • Use Case: Turn a weekly report-generation prompt into a .nika.yaml DAG with typed infer: outputs, a --max-cost-usd spend cap, and CI-pinned golden tests so the workflow runs identically every time.

Quick Start

Ask the agent to capture your repeated AI task as a nika workflow file, run nika check until it passes, and hand you the validated .nika.yaml ready to run.

Frequently Asked Questions about nika

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a nika workflow file?

Start from a template with `nika examples list` and `nika new --from <template> <file>.nika.yaml`, never from scratch. The envelope is always `nika: v1` plus `workflow: <kebab-id>` plus `tasks:`, then validate with `nika check` until it exits clean.

How do I check the cost of an AI workflow before running it?

Run `nika check <file>`, which prints a cost ceiling before any token is spent. A `≤ $X` value is a ceiling, while `≥ $X FLOOR` means a task is unbounded due to missing max_tokens, an uncataloged model, or expression fan-out.

What are the four verbs in a nika workflow?

Each task uses exactly one verb: `infer:` for LLM calls, `exec:` for shell commands as a last resort, `invoke:` for builtins or MCP tools, and `agent:` for bounded multi-turn loops with tool allowlists and turn limits.

Can I test nika workflows offline without API keys?

Yes. Preview with `--model mock/echo` for offline runs, then pin the workflow with `nika test <file> --update` to write a golden file. Subsequent `nika test` runs replay and compare deterministically with zero keys required.

When is it acceptable to use exec in a nika workflow?

Only after confirming no `nika:*` builtin or MCP tool covers the task, such as build tools, git, or CLIs without an MCP surface. Every surviving `exec:` must be documented in the workflow's exec ledger header to pass `--native-strict` review.

How do I verify a nika workflow run actually happened?

Every run writes a hash-chained journal to `.nika/traces/`. Use `nika trace verify <trace>` to check the chain for tampering and `nika trace show <trace>` to read the run card, citing the trace rather than memory.