Skip to content
Back to search

skills

Agent skills for the VisActor visualization ecosystem.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 12 Nov 2026. Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/VisActor/skills with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/VisActor/skills'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/visactor--skills/badge.svg)](/listings/visactor--skills)

HTML

<a href="/listings/visactor--skills"><img src="/api/listings/visactor--skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Install through your agent (recommended)

Send your agent the Skill URL and an installation request:

Please install the chart-storytelling Skill:
https://github.com/VisActor/skills/tree/main/skills/chart-storytelling

Download the complete Skill directory, including SKILL.md, references,
templates and scripts. Install it using a method supported by this app,
then check that the installed Skill can be discovered and invoked.
Tell me if any confirmation or import steps require my help.

For another Skill, open its entry in the table above and use the URL of the folder containing `SKILL.md`. After installation, start a new task and name the Skill you want to use.

If your agent cannot access GitHub or complete installation, use the manual import instructions below.

Command-line installation: Codex / Claude Code

These commands install from the repository's default branch. To use the version on your current branch, [install from your local checkout](#install-from-a-local-checkout).

npx skills add VisActor/skills --skill chart-assistant
npx skills add VisActor/skills --skill chart-storytelling
npx skills add VisActor/skills --skill creative-data-storytelling
npx skills add VisActor/skills --skill editorial-magazine
npx skills add VisActor/skills --skill life-chronicle
npx skills add VisActor/skills --skill person-poster
npx skills add VisActor/skills --skill visactor-light-dashboard
npx skills add VisActor/skills --skill visactor-map2d-dashboard
npx skills add VisActor/skills --skill visactor-chart-editor
npx skills add VisActor/skills --skill visactor-map3d-dashboard

For chart and table tasks, install the related Skills from their owning repositories:

npx skills add VisActor/VChart --skill vchart-development-assistant
npx skills add VisActor/VTable --skill vtable-development-assistant

If you previously installed `data-storytelling`, remove that installed copy and install `chart-storytelling` to use the renamed Skill.

Follow the installer's prompts to select Codex or Claude Code. You can install each Skill independently. More installation options are documented in the [Skills CLI reference](https://github.com/vercel-labs/skills#usage).

Manual import: WorkBuddy / Doubao Work

Open [GitHub Releases](https://github.com/VisActor/skills/releases), choose the latest stable `skills-v*` release, and download the desired Skill ZIP from **Assets**, such as `chart-storytelling.zip` or `visactor-light-dashboard.zip`. Each ZIP contains one complete Skill. Choose the individual Skill asset, rather than the repository's **Source code (zip)** or just `SKILL.md`.

If the app asks for a folder, extract the ZIP and select the folder containing `SKILL.md`. Keep all bundled files.

WorkBuddy

1. Open **专家·技能·连接器 → 技能** (Experts / Skills / Connectors → Skills) in the sidebar. 2. Choose **添加技能 → 上传技能** (Add Skill → Upload Skill), select the downloaded Skill package, and follow the import prompts. 3. Confirm that the Skill is enabled under **已安装** (Installed), then start a task with the Skill name and your data.

See the [official WorkBuddy Skills guide](https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Skills-Market) for the UI flow.

Doubao Work (豆包工作)

1. Open **技能·连接器·伙伴** (Skills / Connectors / Partners) and enter Skill management. 2. Use the local Skill import entry (**上传技能**, Upload Skill). Select the ZIP or the complete extracted Skill folder as requested by the file picker, then finish importing. 3. Start a work task, select the Skill through the Skill picker or name it explicitly in your request, and provide your task data.

Local Skill imports and explicit Skill selection are described in the [official Feishu feature overview](https://www.feishu.cn/content/article/7677519271848610746). Entry labels may differ between app versions; follow the current UI.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 217 lines
  1. # VisActor Skills
  2. [English](README.md) | [简体中文](README.zh-CN.md)
  3. VisActor Skills provides chart, dashboard, data story and poster tools for Claude Code, Codex, WorkBuddy, Doubao Work and other agents that support Skills.
  4. [Website and examples](https://visactor.com/skills) · [Releases](https://github.com/VisActor/skills/releases) · [Contributing](CONTRIBUTING.md)
  5. ## Skills
  6. | Skill | Tasks |
  7. | --- | --- |
  8. | [chart-assistant](skills/chart-assistant/SKILL.md) | Business charts and composition recipes, native KPI cards, MBB analysis annotations, editable Feishu cards, transparent PNGs and document image insertion |
  9. | [chart-storytelling](skills/chart-storytelling/SKILL.md) | Analysis reports, business briefings and data features, with chart scrollytelling and annotations, delivered as HTML stories or Web-PPT |
  10. | [creative-data-storytelling](skills/creative-data-storytelling/SKILL.md) | Create interactive stories that compare quantities, trace patterns across ordered passages or events, or use familiar objects and individual records to explain data. Combine continuous reading with full-bleed stages and optional exploration. Deliver static HTML and assets. |
  11. | [unit-data-storytelling](skills/unit-data-storytelling/SKILL.md) | Create interactive data stories in which each data unit represents a record or a fixed quantity. As readers scroll, particles can gather into a familiar image, then scatter and regroup by time, category, or value in a full-screen view, showing how individual records fit into a larger pattern. |
  12. | [editorial-magazine](skills/editorial-magazine/SKILL.md) | Magazine-style visual posts (杂志风图文): HTML / PNG series for news, biographies, outfits, travel, chronological stories and explainers |
  13. | [life-chronicle](skills/life-chronicle/SKILL.md) | Biography posters with photo walls, center grids, photo rings and editable timelines |
  14. | [person-poster](skills/person-poster/SKILL.md) | Person-led data posters with native VChart, editable HTML and high-resolution PNG |
  15. | [visactor-light-dashboard](skills/visactor-light-dashboard/SKILL.md) | Compact business dashboards with metrics, filters and further analysis |
  16. | [visactor-map2d-dashboard](skills/visactor-map2d-dashboard/SKILL.md) | Interactive 2D map dashboards linking regions, metrics and records |
  17. | [visactor-chart-editor](skills/visactor-chart-editor/SKILL.md) | Self-service chart editing with field drag-and-drop and live data exploration |
  18. | [visactor-map3d-dashboard](skills/visactor-map3d-dashboard/SKILL.md) | 3D globe dashboards for regional analysis and linked evidence |
  19. ### Related VisActor Skills
  20. Chart and table Skills are maintained in their library repositories. Install them directly from the source:
  21. | Skill | Tasks | Repository |
  22. | --- | --- | --- |
  23. | [VChart Skill](https://github.com/VisActor/VChart/blob/develop/skills/vchart-development-assistant/SKILL.md) | Chart generation, diagnosis, image replication and React integration | [VisActor/VChart](https://github.com/VisActor/VChart) |
  24. | [VTable Skill](https://github.com/VisActor/VTable/blob/develop/skills/vtable-development-assistant/SKILL.md) | List tables, pivot tables/charts, interactions and diagnosis | [VisActor/VTable](https://github.com/VisActor/VTable) |
  25. Each Skill can be installed separately and includes its instructions, references and scripts. The agent provides model access and runs the tools.
  26. ## Install
  27. ### Install through your agent (recommended)
  28. Send your agent the Skill URL and an installation request:
  29. ```text
  30. Please install the chart-storytelling Skill:
  31. https://github.com/VisActor/skills/tree/main/skills/chart-storytelling
  32. Download the complete Skill directory, including SKILL.md, references,
  33. templates and scripts. Install it using a method supported by this app,
  34. then check that the installed Skill can be discovered and invoked.
  35. Tell me if any confirmation or import steps require my help.
  36. ```
  37. For another Skill, open its entry in the table above and use the URL of the folder containing `SKILL.md`. After installation, start a new task and name the Skill you want to use.
  38. If your agent cannot access GitHub or complete installation, use the manual import instructions below.
  39. ### Command-line installation: Codex / Claude Code
  40. These commands install from the repository's default branch. To use the version on your current branch, [install from your local checkout](#install-from-a-local-checkout).
  41. ```bash
  42. npx skills add VisActor/skills --skill chart-assistant
  43. npx skills add VisActor/skills --skill chart-storytelling
  44. npx skills add VisActor/skills --skill creative-data-storytelling
  45. npx skills add VisActor/skills --skill editorial-magazine
  46. npx skills add VisActor/skills --skill life-chronicle
  47. npx skills add VisActor/skills --skill person-poster
  48. npx skills add VisActor/skills --skill visactor-light-dashboard
  49. npx skills add VisActor/skills --skill visactor-map2d-dashboard
  50. npx skills add VisActor/skills --skill visactor-chart-editor
  51. npx skills add VisActor/skills --skill visactor-map3d-dashboard
  52. ```
  53. For chart and table tasks, install the related Skills from their owning repositories:
  54. ```bash
  55. npx skills add VisActor/VChart --skill vchart-development-assistant
  56. npx skills add VisActor/VTable --skill vtable-development-assistant
  57. ```
  58. If you previously installed `data-storytelling`, remove that installed copy and install `chart-storytelling` to use the renamed Skill.
  59. Follow the installer's prompts to select Codex or Claude Code. You can install each Skill independently. More installation options are documented in the [Skills CLI reference](https://github.com/vercel-labs/skills#usage).
  60. ### Manual import: WorkBuddy / Doubao Work
  61. Open [GitHub Releases](https://github.com/VisActor/skills/releases), choose the latest stable `skills-v*` release, and download the desired Skill ZIP from **Assets**, such as `chart-storytelling.zip` or `visactor-light-dashboard.zip`. Each ZIP contains one complete Skill. Choose the individual Skill asset, rather than the repository's **Source code (zip)** or just `SKILL.md`.
  62. If the app asks for a folder, extract the ZIP and select the folder containing `SKILL.md`. Keep all bundled files.
  63. #### WorkBuddy
  64. 1. Open **专家·技能·连接器 → 技能** (Experts / Skills / Connectors → Skills) in the sidebar.
  65. 2. Choose **添加技能 → 上传技能** (Add Skill → Upload Skill), select the downloaded Skill package, and follow the import prompts.
  66. 3. Confirm that the Skill is enabled under **已安装** (Installed), then start a task with the Skill name and your data.
  67. See the [official WorkBuddy Skills guide](https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Skills-Market) for the UI flow.
  68. #### Doubao Work (豆包工作)
  69. 1. Open **技能·连接器·伙伴** (Skills / Connectors / Partners) and enter Skill management.
  70. 2. Use the local Skill import entry (**上传技能**, Upload Skill). Select the ZIP or the complete extracted Skill folder as requested by the file picker, then finish importing.
  71. 3. Start a work task, select the Skill through the Skill picker or name it explicitly in your request, and provide your task data.
  72. Local Skill imports and explicit Skill selection are described in the [official Feishu feature overview](https://www.feishu.cn/content/article/7677519271848610746). Entry labels may differ between app versions; follow the current UI.
  73. To update a manually imported Skill, download its package from a newer Release and replace the installed copy through the app’s Skill management page.
  74. ### Runtime requirements
  75. - A host agent with filesystem/shell tools and its own model access; command-line installation also requires Node.js and npm.
  76. - A browser and network access to preview generated HTML and load external assets.
  77. | Skill | Runtime requirements |
  78. | --- | --- |
  79. | chart-assistant | Reading resources and generating/explaining configuration need readable Skill files; bundled scripts require Node.js 18+. PNGs need HTTPS and binary file delivery; document insertion needs authorized host tools or lark-cli; editable cards need the Chart Assistant ISV app. Source sync needs the corresponding plugin, permissions and live binding. See the [compatibility declaration](skills/chart-assistant/SKILL.md) for conditions and fallback delivery. Native KPI and card sizing require host template/protocol support |
  80. | chart-storytelling | Python 3.10+ (standard library) and Node.js for JavaScript checks; pinned VSeed, VChart, VTable and GSAP load from unpkg |
  81. | creative-data-storytelling | Desktop browser with native JavaScript modules; Python 3.9+ (standard library) for the bundled preview server, Node.js for JavaScript checks; optional libraries and fonts may use public CDNs |
  82. | unit-data-storytelling | Modern browser with ES modules; Node.js for module checks; optional Python 3.9+ (standard library) for the bundled preview/audit tool. Bundled examples use local assets without a required CDN or chart library |
  83. | editorial-magazine | Python 3.10+, dependencies in its [requirements.txt](skills/editorial-magazine/requirements.txt), and Chromium/Chrome for PNG export; font CDN with system fallbacks |
  84. | life-chronicle | Python 3.10+, dependencies in its [requirements.txt](skills/life-chronicle/requirements.txt), and Chromium/Chrome for PNG export; pinned VInfo and font CDN, see [environment setup](skills/life-chronicle/references/environment.md) |
  85. | person-poster | Python 3.10+, Pillow, Python Playwright/Chromium; public VChart 2.1.7 CDN or a sourced local copy; see [requirements.txt](skills/person-poster/scripts/requirements.txt) and [environment setup](skills/person-poster/references/environment.md) for POSIX/PowerShell installation and capability limits |
  86. Image search, generation and cutout capabilities come from the host; follow the selected Skill's asset requirements. Magazine templates contain placeholders to replace before delivery. See the owning repositories for VChart/VTable Skill requirements.
  87. Person Poster checks data bindings, source comparisons and image usage records before delivery. Older work bundles need migration; see the [display contract](skills/person-poster/references/display-bindings.md), [evidence guide](skills/person-poster/references/evidence-checks.md) and [rendering guide](skills/person-poster/references/render-and-acceptance.md). These checks do not replace source verification or visual review.
  88. ## Use
  89. After installation, ask your agent to use the selected Skill with your data. For example:
  90. - “Use chart-storytelling to explain retention changes in this CSV to our growth lead as a shareable HTML story.”
  91. - “Use creative-data-storytelling to explain how these historical measurements changed, keeping earlier evidence visible as the story develops.”
  92. - “Use editorial-magazine to turn this article and its sources into an editable HTML and PNG image series.”
  93. - “Use life-chronicle to create a biography poster from these sourced events and photos, with editable timeline text.”
  94. chart-storytelling generates HTML stories and Web-PPT with local scripts. Web-PPT runs in a browser; it is not a `.pptx` file. Image generation requires tools provided by the agent.
  95. Generated JavaScript/HTML is executable code. Preview your own or reviewed artifacts locally; the test browser is not a sandbox for arbitrary untrusted submissions.
  96. ## Examples
  97. The [example gallery](examples/README.md) includes data stories, Web-PPT, magazine layouts and posters, with prompts, inputs and results.
  98. Creative Data Storytelling examples include [historical Chinese measures](examples/creative-data-storytelling/chi-history/README.md), [iPhone prices](examples/creative-data-storytelling/iphone-price-story/README.md) and [annual and cumulative CO₂ emissions](examples/creative-data-storytelling/co2-emissions-history/README.md). Each includes a runnable page, inputs, a prompt and a preview.
  99. Hot nights have become more frequent in Hong Kong. Do they also come in longer runs? Each square represents one summer day. Readers follow a stretch of 21 hot nights in July 2022, see where it falls in a calendar of 65 summers, then compare each summer’s longest stretch by lining them up at the same starting point. [Read the Hong Kong summer story (in Chinese)](examples/unit-data-storytelling/hong-kong-after-dark/README.md)
  100. How has player height changed in the NBA? As readers scroll, the white dots that form the player silhouette in the NBA logo spread out and line up by height within each of the five positions. These players from the 1960s give readers a starting point for comparing height distributions across decades. [Read the NBA height story (in Chinese)](examples/unit-data-storytelling/nba-height-story/README.md)
  101. ## Development and maintenance
  102. Use `develop` for contributions and `main` for stable releases. See the [contribution guide](CONTRIBUTING.md) for development and release procedures.
  103. ### Repository layout
  104. | Path | Contents |
  105. | --- | --- |
  106. | `skills/<skill-name>/` | Independently installable runtime: `SKILL.md`, references, templates/assets and scripts |
  107. | `tests/<skill_name>/` | Skill-specific deterministic regressions; hyphens become underscores for Python imports |
  108. | `tests/test_*` | Shared tooling/installation checks and Node.js browser/Story integration tests |
  109. | `examples/<skill-name>/<case-name>/` | Curated examples with prompts, inputs, results and previews |
  110. | `cases/<skill-name>/<case-name>/` | Fixed Agent prompts, inputs and acceptance guidance |
  111. | `tests/browser/cases/<skill-name>/<case-id>/` | Fixed browser cases: configuration, inputs and expectations |
  112. | `tests/browser/scripts/` | Browser smoke builds and checks; dependencies are pinned in `tests/browser/` |
  113. | `.cache/skill-dev/<skill-name>/<run-name>/` | Ignored local workspaces, outputs, screenshots and logs |
  114. | `docs/` | Contributor references; `docs/migration/` contains historical migration records |
  115. Keep each runtime Skill self-contained. It must not depend on `tests/`, `cases/`, `examples/` or another Skill's local directory. See [contribution conventions](CONTRIBUTING.md#adding-or-updating-a-skill) for adding Skills and selecting checks.
  116. ### Install from a local checkout
  117. From the root of your local repository, install the working copy of a Skill:
  118. ```bash
  119. npx skills add ./skills/chart-storytelling
  120. npx skills add ./skills/creative-data-storytelling
  121. npx skills add ./skills/unit-data-storytelling
  122. npx skills add ./skills/editorial-magazine
  123. npx skills add ./skills/life-chronicle
  124. npx skills add ./skills/person-poster
  125. ```
  126. Alternatively, copy the complete Skill directory into your agent's skill directory, including its references, templates and scripts. Do not copy only `SKILL.md`. See the [local debugging guide](docs/debugging.md) for Codex and Claude Code workspace setup. Refresh the installed copy after changing a Skill before retesting.
  127. ### Regression tests
  128. The Python maintenance environment requires Python 3.12+ and [uv](https://docs.astral.sh/uv/):
  129. ```bash
  130. uv sync --locked
  131. uv run pytest tests -q -m "not poster_browser"
  132. uv run ruff check skills tests
  133. ```
  134. Fixed browser cases live under [tests/browser/cases/](tests/browser/cases/README.md), with configuration, inputs and acceptance criteria together. After the browser setup in that guide, run `uv run python tests/browser/scripts/smoke.py`, or select `--skill chart-storytelling` / `--case story-ppt`. These checks do not call a model.
  135. ### Agent testing
  136. Run a [fixed task](cases/README.md) or your own prompt and data in Codex, Claude Code or another agent. Keep outputs, screenshots and logs in an ignored local workspace; see [local debugging](docs/debugging.md). Agent tasks do not run in CI.
  137. Fixed tasks currently cover chart-storytelling and person-poster. Browser smoke covers stories, Web-PPT and person posters; detailed cases are in the [browser test guide](tests/browser/cases/README.md). Editorial-magazine, life-chronicle and chart-assistant have script regressions but no fixed Agent tasks or real-host browser smoke in this repository. Creative-data-storytelling has deterministic runtime, preview and copied-installation regressions; its bundled mechanism demonstrations are implementation references. Fixed Agent tasks and automated browser smoke for this Skill are not yet included here.
  138. Check generated results for data accuracy, readability and interactions. Automated tests do not establish the quality of an Agent-generated work. Person Poster test results and remaining limitations are recorded in the [validation notes](docs/validation/person-poster-2026-10-28.md).
  139. ## Versioning
  140. Skills in this repository share release tags in the form `skills-vMAJOR.MINOR.PATCH`. Patch versions contain compatible fixes; minor versions add Skills or capabilities; major versions cover incompatible changes. VChart and VTable Skills follow their own repositories’ versions.
  141. Default installations follow `main`. To reproduce an issue, record the installed tag or commit SHA. Each [Release](https://github.com/VisActor/skills/releases) includes one ZIP per Skill and a `skills-manifest.json` with content fingerprints; see the [artifact format](docs/release-artifacts.md).
  142. Maintainers declare the next version in `.github/release-plan.json`. Release PRs run an automatic preview; merging an approved plan into `main` triggers publication after CI passes. See the [release procedure](CONTRIBUTING.md#publishing-skills).
  143. ## Earlier VMind versions
  144. The previous VMind SDK is no longer maintained. Its code and documentation remain in [historical releases](https://github.com/VisActor/skills/releases).
  145. [MIT license](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.