nika: v1
workflow:
  id: seo-content-brief
  description: "Competitor sitemap → top page → gap analysis → typed brief"

model: ollama/qwen3.5:4b   # local · zero key · swap for openai/gpt-5.2

vars:
  topic:
    type: string
    required: true
    description: "The keyword/topic you want to rank for"
  competitor_sitemap: "https://competitor.example.com/sitemap.xml"

tasks:
  map:
    invoke:
      tool: "nika:fetch"
      args:
        url: "${{ vars.competitor_sitemap }}"
        mode: sitemap
    output:
      top: ".[:5] | map(.loc)"

  top_page:
    with:
      map_top: ${{ tasks.map.top[0] }}
    invoke:
      tool: "nika:fetch"
      args:
        url: "${{ with.map_top }}"
        mode: article

  brief:
    with:
      map_top: ${{ tasks.map.top }}
      top_page: ${{ tasks.top_page.output }}
    infer:
      prompt: |
        Topic to rank for · ${{ vars.topic }}
        Competitor's top URLs · ${{ with.map_top }}
        Their best page on it ·
        ${{ with.top_page }}

        Write a content brief that BEATS this page · find the gaps they
        missed · angle for search intent.
      schema:
        type: object
        required: [title, angle, outline, keywords]
        properties:
          title: { type: string }
          angle: { type: string }
          outline: { type: array, items: { type: string } }
          keywords: { type: array, items: { type: string } }

  save:
    with:
      brief: ${{ tasks.brief.output }}
    invoke:
      tool: "nika:write"
      args:
        path: "./briefs/${{ vars.topic }}.json"
        content: "${{ with.brief }}"
        create_dirs: true

outputs:
  brief:
    value: ${{ tasks.brief.output }}
    description: "The typed content brief"

{"a":{"graph_format":2,"workflow":"seo-content-brief","nodes":[{"id":"map","verb":"invoke","tool":"nika:fetch","permits":["tool: nika:fetch"]},{"id":"top_page","verb":"invoke","tool":"nika:fetch","permits":["tool: nika:fetch"]},{"id":"brief","verb":"infer","model":"ollama/qwen3.5:4b","permits":[]},{"id":"save","verb":"invoke","tool":"nika:write","permits":["tool: nika:write"]}],"edges":[{"from":"brief","to":"save","kind":"value"},{"from":"map","to":"brief","kind":"value"},{"from":"map","to":"top_page","kind":"value"},{"from":"top_page","to":"brief","kind":"value"}]},"engine":"0.105.0"}

showcase · tier 2 · content

SEO content brief

Maps the competitor’s sitemap, reads their best page, then writes a typed brief that goes after the gaps.

Your writer starts from gaps and search intent, grounded in pages that actually rank. · conformance-gated in nika-spec ↗ · re-proven at every push

The whole file

4 tasks · 4 waves · the plan falls out of the bindings, nothing is scheduled by hand.

t2-seo-content-brief.nika.yamlsource

1nika: v12workflow:3  id: seo-content-brief4  description: "Competitor sitemap → top page → gap analysis → typed brief"56model: ollama/qwen3.5:4b   # local · zero key · swap for openai/gpt-5.278vars:9  topic:10    type: string11    required: true12    description: "The keyword/topic you want to rank for"13  competitor_sitemap: "https://competitor.example.com/sitemap.xml"1415tasks:16  map:17    ◆invoke:18      tool: "nika:fetch"19      args:20        url: "${{ vars.competitor_sitemap }}"21        mode: sitemap22    output:23      top: ".[:5] | map(.loc)"2425  top_page:26    with:27      map_top: ${{ tasks.map.top[0] }}28    ◆invoke:29      tool: "nika:fetch"30      args:31        url: "${{ with.map_top }}"32        mode: article3334  brief:35    with:36      map_top: ${{ tasks.map.top }}37      top_page: ${{ tasks.top_page.output }}38    ◇infer:39      prompt: |40        Topic to rank for · ${{ vars.topic }}41        Competitor's top URLs · ${{ with.map_top }}42        Their best page on it ·43        ${{ with.top_page }}4445        Write a content brief that BEATS this page · find the gaps they46        missed · angle for search intent.47      schema:48        type: object49        required: [title, angle, outline, keywords]50        properties:51          title: { type: string }52          angle: { type: string }53          outline: { type: array, items: { type: string } }54          keywords: { type: array, items: { type: string } }5556  save:57    with:58      brief: ${{ tasks.brief.output }}59    ◆invoke:60      tool: "nika:write"61      args:62        path: "./briefs/${{ vars.topic }}.json"63        content: "${{ with.brief }}"64        create_dirs: true6566outputs:67  brief:68    value: ${{ tasks.brief.output }}69    description: "The typed content brief"70

nika inspect · engine 0.105.0 · vendored graph, never re-derived

4 declared edges · 4 waves · the plan falls out of the bindings

try itopen in the playground guidethe walkthrough · docs verbinvoke verbinfer toolnika:fetch toolnika:write