Agent skill

Inspector

by QinghongLin in QinghongLin/data2story-skill

Run sentence-level traceability verification on a blog, then generate viewer.html with interactive evidence panel.

MITAuto-check: notesFrontend & Design

Install Inspector

skills CLI
$ npx skills add QinghongLin/data2story-skill --skill inspector -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install QinghongLin/data2story-skill inspector --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/QinghongLin/data2story-skill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/data2story/inspector .claude/skills/inspector && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
inspector
GitHub stars
156
Token cost
~697 tokens
SKILL.md length
263 words
Files
6 (incl. scripts, references)
Skills in repo
31
Repo updated
First seen
Licence
MIT

At a glance

Run sentence-level traceability verification on a blog, then generate viewer.html with interactive evidence panel.

  • Works in 3 steps: Run verify.py → Generate viewer.html → Log Recurring Errors (Optional)
  • Frontend & Design work in your project
  • SKILL.md covers Setup, Step 1: Run verify.py, Step 2: Generate viewer.html and Running both steps, plus 2 more sections
  • Runs Python scripts from its folder; calls python3

What it does

Inspector is an agent skill from QinghongLin/data2story-skill. Run sentence-level traceability verification on a blog, then generate viewer.html with interactive evidence panel. No LLM needed — pure Python.

Its SKILL.md is about 700 tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts and reference files (for example `references/error_logging.json`, `references/inspector_schema.json` and `references/viewer_internals.json`).

It sits in Frontend & Design. It works with Python. The repository describes itself as: Data Journalist Agent: Transforming Data into Verifiable Multimodal Story. The licence is MIT.

When your agent uses it

  • Frontend & Design work in your project

Example prompts

  • “/inspector”

Requirements

  • Python 3
  • Pre-approved tools (allowed-tools): Bash(*), Read, Write

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Run verify.py
  2. Generate viewer.html
  3. Log Recurring Errors (Optional)

What it can do on your machine

Read from SKILL.md and the folder at commit 63a55c1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(*)
    • Read
    • Write

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Inspector loads about 697 tokens when it runs, and up to ~2.1k if it reads all its reference files. Until then it costs about 38 tokens; SKILL.md has 263 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~38
When it runs · the whole SKILL.md, loaded when a task matches
~697
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash(*), Read, Write

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from QinghongLin/data2story-skill at commit 63a55c1, republished under its MIT licence (© QinghongLin). 263 words, ~697 tokens.

Download SKILL.mdSave it as .claude/skills/inspector/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
inspector
description
Run sentence-level traceability verification on a blog, then generate viewer.html with interactive evidence panel. No LLM needed — pure Python.
allowed-tools
Bash(*), Read, Write
argument-hint
PROJECT_DIR

Inspector

Your job is traceability verification. Parse the blog HTML, extract every visible sentence, link each back to its evidence in the role JSONs, and generate a self-contained viewer.html that lets readers inspect the evidence chain.

Setup

  • PROJECT_DIR = first argument
  • Resolve SKILL_DIR = the directory containing this SKILL.md (.../skills/data2story/inspector). Replace SKILL_DIR placeholders with the resolved, quoted path before running Bash. Do not hard-code machine-local paths.
  • Required files in PROJECT_DIR: index.html, analyst.json, detective.json, designer.json, editor.json

Step 1: Run verify.py

bash
python3 SKILL_DIR/scripts/verify.py PROJECT_DIR --log-errors

Produces PROJECT_DIR/inspector.json (sentence→evidence mapping). The output shape (format v3: stats, sentences, unused_ids) is in references/inspector_schema.json.

Step 2: Generate viewer.html

bash
python3 SKILL_DIR/scripts/generate_viewer.py PROJECT_DIR

This reads index.html + inspector.json and produces viewer.html — a self-contained file that works on file:// (no server needed). You run the script; you do not reimplement it. How it works (tag → style → script ordering), its critical constraints (line-number search, lite JSON, ES5, no fetch), and the viewer UI behavior are documented in references/viewer_internals.json.

Running both steps

bash
python3 SKILL_DIR/scripts/verify.py PROJECT_DIR --log-errors
python3 SKILL_DIR/scripts/generate_viewer.py PROJECT_DIR

Output

  • PROJECT_DIR/inspector.json — full traceability data (with raw_evidence)
  • PROJECT_DIR/viewer.html — self-contained interactive viewer (works on file://)

Done when viewer.html opens directly in a browser (no server), shows the blog with a working 🔍 toggle, and every traced sentence has a visible ID linking to its evidence summary.

Step 3: Log Recurring Errors (Optional)

Running with --log-errors auto-updates known recurring-case metadata in skills/errors/ for patterns the script detects directly from HTML. Use manual logging only when you discover a new pattern the script does not know yet — and only for Critical/High-severity issues that represent patterns, not one-off mistakes. The full logging process, the error-case markdown template, and the common error types worth logging are in references/error_logging.json.

© QinghongLin, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (scripts, references) in skills/data2story/inspector of QinghongLin/data2story-skill.

  • SKILL.md
  • references/error_logging.json
  • references/inspector_schema.json
  • references/viewer_internals.json
  • scripts/generate_viewer.py
  • scripts/verify.py

Open the folder on GitHubat commit 63a55c1

Compare with similar skills

Inspector next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Inspector compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Inspector this skillQinghongLin/data2story-skill156—~697Automated safety check: NotesMIT
Claude Desktop Chinese Localizationjavaht/claude-desktop-zh-cn7.5k—~1.6kAutomated safety check: PassMIT
DocsPrefectHQ/fastmcp28k—~1kAutomated safety check: PassApache-2.0
Oil UIoil-oil/oil-ui1.1k—~1.8kAutomated safety check: PassMIT
Language Injectionmicrosoft/data-formulator18k—~1.2kAutomated safety check: PassMIT
Jarvis Setupethanplusai/jarvis843—~2.5kAutomated safety check: NotesCustom licence

Similar skills

  • Claude Desktop Chinese Localization

    javaht/claude-desktop-zh-cn

    Adds missing Simplified and Traditional Chinese translations to the Claude Desktop Chinese patch across three layers, then checks how many mappings actually hit.

    7.5k GitHub stars~1.6k tokensUpdated 4 days ago
    Frontend & DesignAuto-check passed
  • Docs

    PrefectHQ/fastmcp

    Write or revise a page under docs/ for gofastmcp.com. An agent skill from PrefectHQ/fastmcp.

    28k GitHub stars~1k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Oil UI

    oil-oil/oil-ui

    Design, improve, and review interfaces for websites, apps, dashboards, and components: explore distinct design directions, compare styles side by side, and refine visual hierarchy against real…

    1.1k GitHub stars~1.8k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Language Injection

    microsoft/data-formulator

    Official

    LLM Agent 多语言注入规范。在修改 Agent 提示词、添加新的 Agent 端点、处理用户可见的后端消息(messagecode)时使用。

    18k GitHub stars~1.2k tokensUpdated 2 days ago
    Frontend & DesignAuto-check passed
  • Jarvis Setup

    ethanplusai/jarvis

    A skill your agent uses when helping someone install, configure, or debug a fresh clone of JARVIS (this repo) — especially "the mic doesn't work", "JARVIS says his language systems are down", any…

    843 GitHub stars~2.5k tokensUpdated 29 days ago
    Frontend & DesignAuto-check: notes
  • Ibm A11y Route Scan

    langflow-ai/langflow

    Batch-scan Langflow frontend routes for accessibility issues using the Python IBM Equal Access scanner (scripts/a11y/a11yscan.py) and produce JSON/Markdown/HTML reports.

    155k GitHub stars~1.6k tokensUpdated yesterday
    Frontend & DesignAuto-check passed

More from QinghongLin/data2story-skill

All 31 skills in this repo
  • Inspector

    QinghongLin/data2story-skill

    Run sentence-level traceability verification on a Data2Story blog (verify.py - verifier.json), then emit the in-page Inspector panel (the reader-facing runnable verifier) + the verify/ artifacts…

    156 GitHub stars~3.1k tokensUpdated 3 mo ago
    Auto-check: notes
  • Auditor

    QinghongLin/data2story-skill

    Audit a generated Data2Story blog for build correctness across ALL modalities by ACTUALLY RENDERING it in a real headless browser (when available) — catching blank/0-width charts, broken/oversized…

    156 GitHub stars~6.4k tokensUpdated 3 mo ago
    Auto-check: notes
  • Critic

    QinghongLin/data2story-skill

    Review a finished Data2Story blog against the 5 quality rubric dimensions (visualdesign, narrativepacing, datamethodtransparency, claimdataalignment, insightvalue), score each 1-7 with on-page…

    156 GitHub stars~4.7k tokensUpdated 3 mo ago
    Auto-check: notes
  • Detective

    QinghongLin/data2story-skill

    Research external context for a dataset — domain background, history, related studies, and why this data matters.

    156 GitHub stars~2.4k tokensUpdated 3 mo ago
    Auto-check: notes
  • Data2story Pro

    QinghongLin/data2story-skill

    A skill your agent uses to turn a dataset into a verifiable multimedia blog (a data story / data-driven article / interactive dashboard from a dataset).

    156 GitHub stars~14k tokensUpdated 3 mo ago
    Auto-check: notes
  • Openrouter Embeddings

    QinghongLin/data2story-skill

    Generate text embeddings via OpenRouter using Qwen3-Embedding-8B.

    156 GitHub stars~499 tokensUpdated 3 mo ago
    Auto-check passed

Works with

Questions about Inspector

What does Inspector do?

Run sentence-level traceability verification on a blog, then generate viewer.html with interactive evidence panel. Inspector is an agent skill from QinghongLin/data2story-skill.html with interactive evidence panel.

When should I use Inspector?

Inspector fits situations like: frontend & Design work in your project.

How do I install Inspector in Claude Code?

Run `npx skills add QinghongLin/data2story-skill --skill inspector -a claude-code`. Or copy the skill folder (skills/data2story/inspector in QinghongLin/data2story-skill) into .claude/skills/inspector in your project. Claude Code loads it when a task matches its description.

How do I install Inspector in Codex?

Run `npx skills add QinghongLin/data2story-skill --skill inspector -a codex`. Or copy the skill folder (skills/data2story/inspector in QinghongLin/data2story-skill) into .agents/skills/inspector in your project. Codex loads it when a task matches its description.

Can I use Inspector in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add QinghongLin/data2story-skill --skill inspector -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/inspector, .gemini/skills/inspector, .github/skills/inspector and .opencode/skills/inspector in your project.

What does Inspector need to run?

Going by SKILL.md and its folder, Inspector needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3. Its frontmatter pre-approves these tools: Bash(*), Read, Write.

Does Inspector access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Inspector safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Inspector use?

Inspector is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Inspector use?

About 697 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.4k tokens, read only when the agent opens those files.

What are the alternatives to Inspector?

Skills that share tags, products or a category with Inspector: Claude Desktop Chinese Localization (javaht/claude-desktop-zh-cn, 7.5k stars), Docs (PrefectHQ/fastmcp, 28k stars), Oil UI (oil-oil/oil-ui, 1.1k stars) and Language Injection (microsoft/data-formulator, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Inspector?

QinghongLin (a GitHub user) maintains it in QinghongLin/data2story-skill, which has 156 GitHub stars. The repository holds 31 skills in this directory. The repository was last updated on July 5, 2026.

Source: QinghongLin/data2story-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.