Tableau Route

tableau-route

A thin router over the file-based workflow contract. It reads STATE.md in the analyst's project and tells them which one skill to run next — nothing more.

> This skill is a router only. It NEVER invokes another skill inline. Running > the next skill here would share this conversation's context and defeat the > entire point of the plugin (each skill must run in its own fresh conversation). > Your job ends at recommending the next skill and telling the analyst to run > it themselves.

How to run

1. Determine the analyst's project directory (the directory that contains, or

should contain, STATE.md). Default to the current working directory.

1. Run the router script and capture its output:

``bash python "${CLAUDE_SKILL_DIR}/scripts/route.py" "" ``

(Use python3 if python is unavailable.) The script reads STATE.md, applies the ordering rule from CONTRACT.md, and prints the recommended next skill plus a one-line reason. It is pure and read-only — it does not modify any files.

1. Relay the script's recommendation to the analyst, then stop. Tell them to

open a fresh conversation and invoke the recommended skill themselves (e.g. "Run tableau-data next"). Do not call the recommended skill yourself.

Interpreting the result

The script reports one of four situations:

• fresh project (no STATE.md) → recommends tableau-init to scaffold the

project.

• a step is ready → recommends that step's skill (the first step whose status

is pending or stale, with its required inputs satisfied).

• blocked → a required upstream artifact is unresolved or missing on disk;

the script points at the upstream skill to run first.

• done → every step is approved or skipped; point the analyst at their

deliverables under mock-version/v_N/.

If STATE.md looks malformed or the recommendation is surprising, show the analyst the relevant part of STATE.md and refer them to CONTRACT.md (the canonical schema) rather than guessing.

> The full schema and the ordering / staleness / versioning rules live in > CONTRACT.md at the repo root. This skill deliberately restates only what it > needs; route.py is the executable mirror of that contract.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: laviDrori0702
• Source: laviDrori0702/tableau-dashboard-creator-skill
• License: MIT

Install and usage instructions live in the source repository linked above.