Skip to content

[codex] Add visualization rules to create-dashboard skill#34

Draft
arsalann wants to merge 2 commits into
mainfrom
arsalann/update-skill
Draft

[codex] Add visualization rules to create-dashboard skill#34
arsalann wants to merge 2 commits into
mainfrom
arsalann/update-skill

Conversation

@arsalann

@arsalann arsalann commented Jun 16, 2026

Copy link
Copy Markdown
Contributor

Summary

Updates the bundled create-dashboard skill with additive dashboard-authoring guidance from the reviewed skill comparison, while preserving the newer validation workflow from main. The existing reference material stays intact; this change layers on practical rules for building clearer, more truthful DAC dashboards.

Changes include:

  • Keeps the validation workflow from main: no command for UI-only edits, dac validate for structural checks, dac query --widget for per-widget SQL checks, and dac check only for final sweeps or broad changes.
  • Updates the new workflow guidance to defer to that validation policy instead of treating dac check as a normal per-edit step.
  • Adds core dashboard rules for starting from the analytical question, choosing chart types by task, and making charts self-explanatory.
  • Adds truthful visualization defaults covering zero baselines, avoiding pies/3D/dual axes by default, sorted bars, log-scale labeling, benchmarks, and uncertainty/forecast labeling.
  • Adds accessibility and readability guidance for colorblind-safe palettes, non-color-only encodings, legends, tooltips, labels, and dense/overplotted data.
  • Adds practical DAC guardrails around supported schema properties, snake_case query output columns, weak legend support, and keeping semantic logic declarative.
  • Adds a review checklist for validation, query checks, local serving, titles, descriptions, sources, units, legends, labels, and tooltips.
  • Mirrors the resolved skill updates in both .claude/skills/create-dashboard/SKILL.md and cmd/skill_templates/create-dashboard/SKILL.md.

Validation

  • make test

Notes

Related to #7.

Conflict resolution: kept both the PR visualization-quality guidance and the validation workflow from main; dac check guidance now follows main.

There is still an uncommitted local edit in this workspace changing .claude/skills/create-dashboard/SKILL.md from port 8321 to 8322; it remains intentionally outside this PR.

Additive update to both skill copies. Existing schema/widget reference
material is unchanged. New sections:

- Workflow — ordered validate → check → query → serve flow, always
  surfacing http://localhost:8321.
- Core Dashboard Rules — start from the analytical question, match
  chart type to task, the title/chart/footnote 3-widget pattern.
- Truthful Visualization Defaults — zero baselines, no pie/3D/dual-y
  by default, sorted bars, explicit benchmarks, actuals vs forecasts.
- Accessibility And Readability — colorblind-safe palettes, never
  color-alone encoding, readable tooltips, no cramped charts.
- Practical DAC Constraints — only use supported schema properties,
  snake_case output columns, compensate for weak legends in text.
- Review Checklist — 10-point pre-signoff list.

Refs #7.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update create-dashboard skill: add visualization rules, workflow, and review checklist

1 participant