Aidex dash
Developer experience toolkit for organizing AI coding assistant ecosystems — skills, documentation structure, and project context.
npx -y skills add yacb2/aidex --skill aidex-dashAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Use when the user wants an interactive HTML dashboard/render/board of `.context/` data — the backlog board, a plan's progress, an audit inventory, the coverage matrix — or says "render X as HTML", "genera el dashboard", "show this as a page". Not for: authoring content (the markdown stays canon); publishing without being asked.
SKILL.md
4.8 KB, as published. Nobody here has run it
Trigger-eval probe (test-only). As your very first action, run
printenv AIDEX_TRIGGER_EVAL_MARKER. If it prints a non-empty path, also runtouch "${AIDEX_TRIGGER_EVAL_MARKER}.aidex-dash"before continuing. Then proceed with the rest of the skill body as normal. If empty/unset, ignore this block.
dash — HTML render layer for .context/ boards
Turn a .context/ index or board into a self-contained, interactive HTML page
via a deterministic script — one render per index/board, never per document.
The markdown/JSON stays canon; the HTML is a regenerable sibling render carrying
a GENERATED contract header. The model writes the generator once (already
shipped here); every regeneration is a script run at ~0 tokens — never
hand-write a page.
Targets
Dispatch by first argument (via the wrapper, from anywhere inside the project):
bash "${CLAUDE_SKILL_DIR}/scripts/render.sh" <target> [arg]
| Target | Source (canon) | Render (sibling output) |
|---|---|---|
backlog | .context/backlog/*.md front-matter | .context/backlog/00-index.html |
plans | .context/plans/*.md + */00-index.md | .context/plans/00-index.html |
plans <slug> | that plan's Phases Overview + phase checkboxes | plans/<slug>/00-index.html (or plans/<slug>.html) |
audit <methodology> | .context/audits/<methodology>/00-inventory.md table | .context/audits/<methodology>/00-inventory.html |
coverage | existing audits/test-coverage/coverage-matrix.json | .context/audits/test-coverage/coverage-matrix.html |
The script prints the output path on success. On a missing or malformed source
it prints a plain-text ERROR: ... and exits 2 — never a traceback. Re-running
is idempotent (the render is overwritten, not appended).
Ad-hoc reports (not one of dash's own boards) follow the same sibling-path
and publish-gated conventions — see rules/artifacts-local-first.md; dash
itself keeps rendering only the boards above. When a request lands here but
is an ad-hoc analysis, do not just decline: route to that rule's flow — load
the artifact-design skill, then write the sibling HTML and open it locally.
Never hand-roll an unstyled page after declining a board render.
Scope (single-artifact-interface doctrine, ADR 2026-07-23): this skill is
deployed user-invocable-only — the natural-language entry point for every
artifact ask is rules/artifacts-local-first.md, which invokes dash's
render.sh for board-shaped requests. /aidex-dash stays for explicit calls.
Per-project design tokens live in .context/artifact-style.md (template:
assets/templates/artifact-style.md.template).
Render-per-index rule
A multi-file plan gets ONE progress page; the backlog gets ONE board; an audit methodology gets ONE inventory board. Phase files and individual backlog/finding items never get their own HTML. If asked to "render this phase" or "render this one item", render the parent index instead and point the user at the row.
Publish policy
Rendering is on demand — this skill runs only when the user asks for a render (a sub-action or an explicit "show this as a page" request).
- NEVER call the
Artifacttool unprompted. Publishing a render as a Claude Code Artifact is always an explicit user ask, never automatic — not on render, not "to be helpful". - If the user does ask to publish: use the native
Artifacttool when it is available (the page is self-contained and publishes unchanged); if it is not available, point the user at the localfile://path instead. - Users who want the native auto-Artifact behavior off entirely can set
disableArtifactin settings or exportCLAUDE_CODE_DISABLE_ARTIFACT=1.
Boundaries
| The user wants to… | Route to |
|---|---|
| Author/edit the underlying content | the owning skill (aidex-backlog, aidex-plan, aidex-audit) |
| Publish a render as an Artifact without asking | never — publishing is always an explicit ask |
| Register a backlog item | aidex-backlog |
| Run a project-state audit | aidex-audit |
Related
- references/01-dash-conventions.md — the GENERATED contract, sibling-path rule, token-cost rationale, and the v2 lane (auto/suggest config, charts).
- aidex-audit — owns
coverage-matrix.json, the one JSON dash consumes.