agentleFS
Sign inStart free
MAGA2010MAGA2010/data-master/skills/visualizer/SKILL.md

visualizer

Skill78 starsChanged 23 days agoMITView on GitHub

Decide and render one figure per argument: chart type chosen against alternatives, title states the finding, caption defines the encoding, body gives fact -> interpretation -> implication.

3 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

7 rules. About 0 are common, 6 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈6

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    After statistics exist. The decision layer runs even when no figure is produced -- "no chart says anything a table does not" is itself a …

    line 17
  2. Distinctive:

    every decision names the chart types it rejected and why.

    line 42
  3. Distinctive:

    every title states a finding, not a topic.

    line 43
  4. Very specific:

    every figure passes its blank-page check (non_blank: true, ink ratio above zero).

    line 44
  5. Distinctive:

    do not use 3D unless it changes the ranking.

    line 58
  6. Distinctive:

    do not use a rainbow palette for an ordered variable.

    line 59
  7. Distinctive:

    do not render a figure whose decision record has no rejected alternative.

    line 60

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

visualizer

Stage 3a of the data-master pipeline. The router in ../../SKILL.md owns the end-to-end run; this skill owns one stage and one gate. Read the parent contract before changing anything here: the invariants in ../../SKILL.md (additive-only, types decided once, default-FAIL gates, three-part provenance) are not restated, they are inherited.

When to invoke

After statistics exist. The decision layer runs even when no figure is produced -- "no chart says anything a table does not" is itself a recorded decision.

Inputs

  • cleaned data
  • analysis/profile.json, descriptive.json, inferential.json

Outputs

  • analysis/chart_decisions.json: palette, markers, decisions[{id, chart_type, spec, uncertainty, title, caption, body{fact, interpretation, implication}, rationale, rejected, output_path, order}], rules, dtype_provenance
  • outputs/charts/*.png at 200 dpi
  • outputs/charts_rendered.json: per-figure bytes, ink_ratio, non_blank, pixels

Commands

python scripts/chart_decision.py --clean outputs/cleaned/cleaned.csv --profile outputs/analysis/profile.json --descriptive outputs/analysis/descriptive.json --inferential outputs/analysis/inferential.json --out outputs/analysis/chart_decisions.json
python scripts/render_chart.py --clean outputs/cleaned/cleaned.csv --decisions outputs/analysis/chart_decisions.json --outdir outputs/charts

Gate (default FAIL)

  • every decision names the chart types it rejected and why;
  • every title states a finding, not a topic;
  • every figure passes its blank-page check (non_blank: true, ink ratio above zero);
  • a comparison figure states its interval (error bars, band or CI).

Failure modes seen in real runs

  • A title and a subtitle drawn at the same anchor. suptitle(wrap=True) keeps y=0.98 and grows downward into whatever sits below it; wrap by measured width and place each line explicitly.
  • A blank figure that saves without error. Ink ratio is read back from the PNG after save, because a successful savefig proves only that a file exists.
  • The same argument drawn as three separate figures. Panels, not repeats.

Do not

  • do not use 3D unless it changes the ranking;
  • do not use a rainbow palette for an ordered variable;
  • do not render a figure whose decision record has no rejected alternative.

Upstream / downstream

  • previous: ../statistical-analyzer/SKILL.md
  • next: ../report-generator/SKILL.md
  • catalog: ../../references/chart-decision-catalog.md

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free