docs-image

docs-image is a skill for Claude Code, Codex from nexus-substrate/nexus-agents. It costs 99 tokens per session (1,368 once invoked), scanned A, original, MIT.

Instructions for creating AI-generated illustrations for documentation, such as hero images, covers, conceptual artwork, and approximate infographics. It distinguishes these from exact technical diagrams, which should use Mermaid.

In plain words
What is it for?
Use it to create documentation cover images, conceptual visuals, or broad process illustrations, while redirecting exact architecture and quantitative diagrams to more suitable tools.
Why use it?
It helps choose an appropriate visual method: AI artwork for illustrative ideas and text-based Mermaid diagrams for precise components, connections, or sequences.

Skill for Claude CodeCodex

Part of the nexus-agents plugin — 33 skills, 16 agents, 1 hook shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/nexus-substrate/nexus-agents/docs-image
Any agent
npx skills add nexus-substrate/nexus-agents --skill docs-image
Clone the repo
git clone --depth 1 https://github.com/nexus-substrate/nexus-agents

Made for: Claude Code, Codex.

Or install nexus-agents, the plugin that ships this one along with the rest of its 33 skills, 16 agents, 1 hook.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for docs-image

README.md
[![agentmods](https://agentmods.dev/badge/skills/nexus-substrate/nexus-agents/docs-image.svg)](https://agentmods.dev/skills/nexus-substrate/nexus-agents/docs-image)
Your own site
<a href="https://agentmods.dev/skills/nexus-substrate/nexus-agents/docs-image"><img src="https://agentmods.dev/badge/skills/nexus-substrate/nexus-agents/docs-image.svg" alt="Measured on agentmods" height="20"></a>
Per session 99 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,368 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00099 $0.01368
Opus 5 $0.00049 $0.00684
Sonnet 5 $0.00020 $0.00274
Haiku 4.5 $0.00010 $0.00137

Measured 4d ago against content hash 2e741a16d29a, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

docs-image scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/docs-image/SKILL.md · 148 lines

How it starts

The opening of the file, as written. The whole thing — 148 lines — stays where its author put it; the contents beside it link to each section on GitHub.

AI Illustrations Skill

When to apply

Use AI image generation in three specific cases:

  1. Hero / cover images — README header, blog post cover, major architecture doc landing image
  2. Conceptual illustrations — abstract / editorial mode for "what consensus voting feels like" — illustrative, not load-bearing
  3. Infographic-mode visualizations — shape of an approach, layered process flows where "approximate shape" beats "exact byte path"

For everything else, redirect.

Step 1 (CRITICAL) — Mermaid-first check

Before generating, ask: "Is this a 'show how X works' question with precise components / sequence / state?"

If YES → recommend docs-mermaid. State the rule of thumb: "Mermaid wins for precise diagrams: it's text-based, diff-able, and renders accurately. AI images are wrong for this — they look right until you check the details."

If NO and the request is genuinely illustrative ("show me what consensus feels like", "hero for the README"), proceed to step 2.

This guardrail is the highest-priority rule in the skill. Skipping it produces architecture diagrams that look plausible but are wrong in detail.

Step 2 — Select domain mode

Mode When to use Prompt emphasis
Infographic (default) Layered process shape, comparison panels Layout structure, hierarchy, accessible colors
Editorial Hero / blog cover with mood Composition, lighting, publication references
Abstract Pattern background, decorative section divider Color theory, mathematical forms, textures
UI/Web Tech illustration with vector / flat-design feel Clean lines, exact colors, icon-style

Read the full file on GitHub · 148 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 148 lines · 99 tokens per session scan A 2e741a16d29a

Subscribe to this mod's changes

docs-image is a skill published in the GitHub repository nexus-substrate/nexus-agents (18 stars, last pushed today), licensed MIT. It adds 99 tokens to every session and 1,368 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

general-video

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated…

heygen-com/hyperframes · 92 tokens

media-ingest

Ingest video, audio, PDF, book, screenshot, and GitHub repo content into the brain. Multi-format handling with entity extraction and backlink propagation. Covers video-ingest, youtube-ingest, and book-ingest subtypes.

garrytan/gbrain · 52 tokens

diagnostic-stem-delivery

Audio production with diagnostic analysis, timecode parsing from documents, and verified export workflow.

HKUDS/OpenSpace · 23 tokens

chengfeng-cut

剪辑中文口播原素材:逐词转录、词典修字出修字表、五轮扫描找口误与重复、汇总表与重复句子表、打开 Studio 让用户复核、复盘沉淀用户偏好与词典。只产出一份已复核的删词账本,不切媒体、不做字幕、不做分镜动画。用户说剪口播、处理口误、生成口播基础素材、继续剪口播,或确认卡回传 action=returncutreview 时使用。不要用于执行物理剪切、导出剪后视频、单独安装、单独打开工作台或口播分镜成片。.

Agentchengfeng/chengfeng-videocut-skills · 154 tokens

chengfeng-check-updates

剪辑环境的唯一管理者:就绪检查(skills 是否最新 → Runtime 是否配套)、Skills 更新激活、Runtime 安装与体检。用户说检查更新、安装剪辑环境、装播放器、检查剪辑环境、剪辑环境就绪了吗、配置转录凭证时使用;业务 Skill(剪口播/字幕/画面/导出)第 0 步也引用本 Skill 的就绪检查。不用于剪辑、字幕、画面、导出本身或项目数据迁移。.

Agentchengfeng/chengfeng-videocut-skills · 120 tokens

infographic-template-updater

Update template catalogs and UI prompts after adding new infographic templates (src/templates/.ts), including SKILL.md template list, site gallery template mappings, and the AIPlayground prompt list.

antvis/Infographic · 43 tokens