Agents

Route chart discussion, feedback, recommendations, and catalog improvement drafts through chartcoach Agent integrations.

chartcoach provides Agent integrations through agent skills and MCP tools. The top-level $chartcoach skill routes tasks to workflow skills bundled with the installed chartcoach package.

npx skills add chartcoach/skills

uvx chartcoach@latest skills list

Invoke $chartcoach in the current agent session:

codex \
  'Use $chartcoach to review this chart screenshot for labels, legends, and accessibility.'

Skill paths

Skill	Use it for
`core`	Catalog source, output formats, command recovery, and index setup
`discuss`	Cited design discussion, tradeoffs, comparisons, and source tracing
`visfeedback`	Feedback on an observed chart or screenshot
`visrec`	Visualization recommendations from a data task and constraints
`contribute`	Local catalog improvement issue drafts

Inspect bundled skill text:

uvx chartcoach@latest skills list --format jsonl

uvx chartcoach@latest skills get core

uvx chartcoach@latest skills get visfeedback

Evidence flow

Agents should separate discovery from cited evidence before writing feedback:

catalog shape -> candidate guidelines -> exact guideline -> citation -> answered claim

Read the live catalog shape with overview, manifest, roles, and labels. Discover candidate guidelines with list, query, sql, or find. Verify each candidate guideline with catalog read, then produce links and source references with catalog cite.

The list, query, sql, and find commands discover candidate guidance. catalog read fetches the exact text an agent should inspect before writing a sourced claim.

uvx chartcoach@latest catalog query --label chart:bar:use --limit 5 --format jsonl

uvx chartcoach@latest catalog read compare-percentages-with-bars-not-pies \
  --source-detail minimal \
  --format json

uvx chartcoach@latest catalog cite compare-percentages-with-bars-not-pies \
  --format json

Contribution drafts

Use contribute after retrieval identifies a catalog gap, conflict, duplicate, or guideline with unclear application. The skill drafts local issue Markdown for human review.

uvx chartcoach@latest skills get contribute

The draft stays local until a human approves posting, submitting, or disclosing it.

MCP provides catalog SQL and search as tool invocations for agent platforms.

Skill paths

Evidence flow

Contribution drafts

On this page