How do I install the Figure Audit skill?

Run npx skillmds@latest add slogsdon/figure-audit in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Figure Audit safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Figure Audit?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Figure Audit free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Figure Audit?

slogsdon (@slogsdon) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Figure Audit by slogsdon — Agent Skill

Name: Figure Audit
Author: slogsdon

Figure Audit

Decide whether a given article should get a figure at all — additive, performative, or none — against a five-type taxonomy where each type has a hard entry requirement. Use when Shane says "should this post have a diagram", "audit these articles for figures", "does this need a chart", or before commissioning any illustration for written work. Do NOT use to build the figure once approved (use the design artifact skills), to audit an existing figure's styling, or for social artifacts, which are decorative by design.

slogsdon 9f94eed 3.5 KB Updated Sep 17, 2026

File contents

Skill: /figure-audit [article path]

Answer whether a figure earns its place, applying the standard that most articles should get none — the value is in the rejections, not the approvals.

Don't: invent the data a figure would need; if the article does not contain the numbers, the verdict is not additive, full stop. Don't approve a figure that restates the thesis in boxes — that is the exact failure this guards against. Don't audit several articles in one agent; it starts pattern-matching the second against the first and stops reading.

The standard

If the page is no worse without the figure, cut the figure.

Prefer none. Reaching for a figure to fill space is the failure mode.

The taxonomy

A figure may ONLY be one of these five types, and ONLY if it meets its entry requirement.

Figure	Use it for	REQUIRES
Dimensioned diagram	A claim about proportion, or where a line sits	Two regions and a measured split you can defend
Cycle	A process with a genuine return edge	Three or more stages AND a real loop back
Record chart	A claim about the author's own history or data	A file it reconciles to, named in the caption
Detail	Clarifying one step of an assembly	A step that is actually unclear without it
Footed table	Anything with numbers, including pricing	Figures that add up, shown adding up

Hard limits: max one figure per article, max three callouts per figure. Zero figures is a perfectly good answer.

Rules

No invented data. groundedIn must quote or cite something actually in the article.
Record chart needs a real file it reconciles to. Do not claim reconciliation you cannot verify.
Cycle needs a genuine return edge. A linear process with steps is not a cycle.
Dimensioned diagram needs a defensible measured split — an explicit percentage or ratio stated in the article. A vibes-based split is not defensible.
Prefer none.

Steps

Read the project's DESIGN.md figure section — if it defines a different taxonomy, that file wins over the table above.
Read the article in full. Not the intro, not a grep.
Test each of the five types against its entry requirement, in order. Stop at the first that genuinely passes.
Return the verdict.

Output

slug:            <slug>
verdict:         additive | performative | none
figureType:      <one of the five, or null>
depicts:         <name the actual regions / stages / values — not "the process">
entryRequirement: <how it is met, or which requirement each type failed>
groundedIn:      <quote or cite from the article>

none still fills entryRequirement — say which requirement each type failed. A bare "none" is not reviewable.

Fan-out

One agent per article, in parallel, each blind to the others. When auditing a set, follow with a single skeptic pass over the collected verdicts to catch a reviewer who drifted lenient.

---name: figure-auditdescription: Decide whether a given article should get a figure at all — additive, performative, or none — against a five-type taxonomy where each type has a hard entry requirement. Use when Shane says "should this post have a diagram", "audit these articles for figures", "does this need a chart", or before commissioning any illustration for written work. Do NOT use to build the figure once approved (use the design artifact skills), to audit an existing figure's styling, or for social artifacts, which are decorative by design.---# Skill: /figure-audit [article path]Answer whether a figure earns its place, applying the standard that most articles should get none — the value is in the rejections, not the approvals.**Don't:** invent the data a figure would need; if the article does not contain the numbers, the verdict is not additive, full stop. **Don't** approve a figure that restates the thesis in boxes — that is the exact failure this guards against. **Don't** audit several articles in one agent; it starts pattern-matching the second against the first and stops reading.## The standard> If the page is no worse without the figure, cut the figure.Prefer `none`. Reaching for a figure to fill space is the failure mode.## The taxonomyA figure may ONLY be one of these five types, and ONLY if it meets its entry requirement.| Figure | Use it for | REQUIRES ||---|---|---|| Dimensioned diagram | A claim about proportion, or where a line sits | Two regions and a measured split you can defend || Cycle | A process with a genuine return edge | Three or more stages AND a real loop back || Record chart | A claim about the author's own history or data | A file it reconciles to, named in the caption || Detail | Clarifying one step of an assembly | A step that is actually unclear without it || Footed table | Anything with numbers, including pricing | Figures that add up, shown adding up |Hard limits: **max one figure per article**, max three callouts per figure. Zero figures is a perfectly good answer.## Rules1. **No invented data.** `groundedIn` must quote or cite something actually in the article.2. **Record chart** needs a real file it reconciles to. Do not claim reconciliation you cannot verify.3. **Cycle** needs a genuine return edge. A linear process with steps is not a cycle.4. **Dimensioned diagram** needs a defensible measured split — an explicit percentage or ratio stated in the article. A vibes-based split is not defensible.5. **Prefer `none`.**## Steps1. Read the project's `DESIGN.md` figure section — if it defines a different taxonomy, that file wins over the table above.2. Read the article **in full**. Not the intro, not a grep.3. Test each of the five types against its entry requirement, in order. Stop at the first that genuinely passes.4. Return the verdict.## Output```slug: <slug>verdict: additive | performative | nonefigureType: <one of the five, or null>depicts: <name the actual regions / stages / values — not "the process">entryRequirement: <how it is met, or which requirement each type failed>groundedIn: <quote or cite from the article>````none` still fills `entryRequirement` — say which requirement each type failed. A bare "none" is not reviewable.## Fan-outOne agent per article, in parallel, each blind to the others. When auditing a set, follow with a single skeptic pass over the collected verdicts to catch a reviewer who drifted lenient.

Frequently asked questions