---
name: automagik-dev/genie
source: https://app.decimal.ai/s/automagik-dev-genie@4/SKILL.md
source_sha256: 0afd41df423b
---

# Genie Cockpit Pointer

Genie is the execution system and the source of task truth. When a workspace
contains `.genie/`, treat Genie state — wishes, tasks, boards, worker status —
as canonical over anything scraped from a terminal.

## Load the product skills, don't duplicate them

- For planning, execution, and review posture, load the first-class product
  skills directly: `wish`, `work`, and `review`. This plugin no longer ships
  `genie-work`/`genie-review` duplicates — the product skills are canonical.

## Use MCP for board truth

- Read board and task state through the genie MCP tools (`genie_board`,
  `genie_wish_status`, `genie_task`) rather than terminal scraping. The native
  Hermes surface only adds the gap tools MCP does not cover: `genie_status`
  (doctor plus `.genie` presence), `genie_work_plan` (`context --plan` spawn preview), and
  `genie_review_plan` (wish status plus acceptance criteria).
- Never poll panes with `tmux capture-pane` or `sleep` loops to infer worker
  progress. The structured tools return the same truth with provenance.

## Human gates on mutation

- Every tool in this plugin is read-only (`mutation: "none"`).
- Mutations — `genie spawn`, a non-plan `genie context` resolution, `genie task
  done` — require explicit human approval before they run, every time.

## Report outcome-first

- Lead with the outcome, then the key facts, then the exact CLI evidence:
  the `genie ...` argv that produced the data, on one line.