VisActor/skills

Última atividade de origem registrada: 4 de novembro de 2026 às 06:59

Catálogo do SkillsMP atualizado: 9 de novembro de 2026 às 14:22

skills coletadas: 11

Estrelas no GitHub: 473
Forks no GitHub: 89

Instalar com um assistente de IA

Copie este prompt para o assistente de IA que você usa.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/VisActor/skills.

README do repositório

Arquivo de origem do README: README.md

Ler o README original

Expandir README completo

# VisActor Skills [English](README.md) | [简体中文](README.zh-CN.md) VisActor Skills provides chart, dashboard, data story and poster tools for Claude Code, Codex, WorkBuddy, Doubao Work and other agents that support Skills. [Website and examples](https://visactor.com/skills) · [Releases](https://github.com/VisActor/skills/releases) · [Contributing](CONTRIBUTING.md) ## Skills | Skill | Tasks | | --- | --- | | [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 | | [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 | | [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. | | [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. | | [editorial-magazine](skills/editorial-magazine/SKILL.md) | Magazine-style visual posts (杂志风图文): HTML / PNG series for news, biographies, outfits, travel, chronological stories and explainers | | [life-chronicle](skills/life-chronicle/SKILL.md) | Biography posters with photo walls, center grids, photo rings and editable timelines | | [person-poster](skills/person-poster/SKILL.md) | Person-led data posters with native VChart, editable HTML and high-resolution PNG | | [visactor-light-dashboard](skills/visactor-light-dashboard/SKILL.md) | Compact business dashboards with metrics, filters and further analysis | | [visactor-map2d-dashboard](skills/visactor-map2d-dashboard/SKILL.md) | Interactive 2D map dashboards linking regions, metrics and records | | [visactor-chart-editor](skills/visactor-chart-editor/SKILL.md) | Self-service chart editing with field drag-and-drop and live data exploration | | [visactor-map3d-dashboard](skills/visactor-map3d-dashboard/SKILL.md) | 3D globe dashboards for regional analysis and linked evidence | ### Related VisActor Skills Chart and table Skills are maintained in their library repositories. Install them directly from the source: | Skill | Tasks | Repository | | --- | --- | --- | | [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) | | [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) | Each Skill can be installed separately and includes its instructions, references and scripts. The agent provides model access and runs the tools. ## Install ### Install through your agent (recommended) Send your agent the Skill URL and an installation request: ```text 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). ```bash 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: ```bash 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. 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. ### Runtime requirements - A host agent with filesystem/shell tools and its own model access; command-line installation also requires Node.js and npm. - A browser and network access to preview generated HTML and load external assets. | Skill | Runtime requirements | | --- | --- | | 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 | | chart-storytelling | Python 3.10+ (standard library) and Node.js for JavaScript checks; pinned VSeed, VChart, VTable and GSAP load from unpkg | | 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 | | 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 | | 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 | | 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) | | 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 | 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. 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. ## Use After installation, ask your agent to use the selected Skill with your data. For example: - “Use chart-storytelling to explain retention changes in this CSV to our growth lead as a shareable HTML story.” - “Use creative-data-storytelling to explain how these historical measurements changed, keeping earlier evidence visible as the story develops.” - “Use editorial-magazine to turn this article and its sources into an editable HTML and PNG image series.” - “Use life-chronicle to create a biography poster from these sourced events and photos, with editable timeline text.” 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. Generated JavaScript/HTML is executable code. Preview your own or reviewed artifacts locally; the test browser is not a sandbox for arbitrary untrusted submissions. ## Examples The [example gallery](examples/README.md) includes data stories, Web-PPT, magazine layouts and posters, with prompts, inputs and results. 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. 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) 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) ## Development and maintenance Use `develop` for contributions and `main` for stable releases. See the [contribution guide](CONTRIBUTING.md) for development and release procedures. ### Repository layout | Path | Contents | | --- | --- | | `skills/<skill-name>/` | Independently installable runtime: `SKILL.md`, references, templates/assets and scripts | | `tests/<skill_name>/` | Skill-specific deterministic regressions; hyphens become underscores for Python imports | | `tests/test_*` | Shared tooling/installation checks and Node.js browser/Story integration tests | | `examples/<skill-name>/<case-name>/` | Curated examples with prompts, inputs, results and previews | | `cases/<skill-name>/<case-name>/` | Fixed Agent prompts, inputs and acceptance guidance | | `tests/browser/cases/<skill-name>/<case-id>/` | Fixed browser cases: configuration, inputs and expectations | | `tests/browser/scripts/` | Browser smoke builds and checks; dependencies are pinned in `tests/browser/` | | `.cache/skill-dev/<skill-name>/<run-name>/` | Ignored local workspaces, outputs, screenshots and logs | | `docs/` | Contributor references; `docs/migration/` contains historical migration records | 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. ### Install from a local checkout From the root of your local repository, install the working copy of a Skill: ```bash npx skills add ./skills/chart-storytelling npx skills add ./skills/creative-data-storytelling npx skills add ./skills/unit-data-storytelling npx skills add ./skills/editorial-magazine npx skills add ./skills/life-chronicle npx skills add ./skills/person-poster ``` 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. ### Regression tests The Python maintenance environment requires Python 3.12+ and [uv](https://docs.astral.sh/uv/): ```bash uv sync --locked uv run pytest tests -q -m "not poster_browser" uv run ruff check skills tests ``` 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. ### Agent testing 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. 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. 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). ## Versioning 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. 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). 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). ## Earlier VMind versions The previous VMind SDK is no longer maintained. Its code and documentation remain in [historical releases](https://github.com/VisActor/skills/releases). [MIT license](LICENSE)

Carregando o README do repositório…

Skills neste repositório

classificação pendente

skill

ocupação

descrição

atualizado

unit-data-storytelling

sem classificação

用单元可视化制作交互式数据故事，每个数据单元代表一条记录或固定数量。适合用点、图标、图片或文本呈现分布、构成、贡献与记录序列，也可用粒子动画让点阵聚成形象，再随阅读散开，按数据重排。支持从材料研究、叙事设计到网页实现与交互探索。

Idioma do texto original: chinês

2026-11-04

creative-data-storytelling

sem classificação

将数据、文本档案或研究发现制作成面向公众的交互式可视化叙事。根据数据结构与关键发现设计全出血舞台、多章节阅读、素材、动画和探索；用于数据故事的研究、分镜设计、网页实现与迭代。

Idioma do texto original: chinês

2026-11-04

chart-assistant

sem classificação

在飞书文档写报告时创建、编辑和交付图表助手可编辑图表卡片。覆盖柱/条形（堆叠、并列、百分比、重叠对照）、折线、面积、散点/气泡、双轴、饼/环、玫瑰、雷达、漏斗、词云、桑基、热力图、Treemap/Sunburst 等 30+ 内置图型，以及瀑布/桥图、Mekko、子弹图、哑铃图、蝴蝶图、小倍数面板等商务图表，图表类型、标注和编辑能力整体对齐 ThinkCell；默认遵循…

Idioma do texto original: chinês

2026-11-02

person-poster

sem classificação

创建、编辑和优化人物主导、数据密集、视觉统一的人物数据信息图与生涯海报，输出可编辑 HTML 和高清 PNG。适用于运动员、音乐人、演员、创作者、历史人物等人物专题，或参考人物剪影周围编排数据的杂志式信息图。仅有人物姓名不构成触发条件；单张统计图、普通人物介绍文章、以及明确要求 Page Schema/VStory 的任务不走此流程。

Idioma do texto original: chinês

2026-10-29