feat: add antv-s2-expert skill by Copilot · Pull Request #31 · antvis/chart-visualization-skills

Copilot · 2026-02-25T06:39:01Z

New skill to help LLMs understand S2's API and usage patterns for multi-dimensional cross-analysis table development (@antv/s2, @antv/s2-react, @antv/s2-vue, @antv/s2-react-components, @antv/s2-ssr).

Content extracted and translated to English from the S2 source repo docs (s2-site/docs/manual/, s2-site/common/, s2-site/docs/api/, s2-site/examples/).

Structure

skills/antv-s2-expert/
├── SKILL.md                          # Role definition, 23-entry query routing table, code generation rules
└── references/
    ├── knowledge/  (00–16)           # Core concepts & guides
    ├── type/       (5 files)         # TS type references (S2Options, S2DataConfig, S2Theme, S2Event, SheetComponent)
    └── examples/   (7 files)         # Runnable code examples

SKILL.md

Query routing table maps user intent keywords → specific reference files (e.g. "frozen" → knowledge/13-frozen.md, "S2Options" → type/s2-options.md)
Code generation guidelines: prefer TS, use <SheetComponent> for React, S2DataConfig/S2Options types, S2Event for listeners, cell customization via class extension

Reference files

knowledge/ — 17 files covering overview, sheet types, framework bindings, theme/style, custom cells, events/interaction, data config, sort, totals, copy/export, pagination, conditions, tooltip, frozen, icons, SSR, React analysis components
type/ — 5 files with full property tables for S2Options, S2DataConfig, S2Theme, S2Event, SheetComponent props
examples/ — 7 files with complete TypeScript examples: pivot/table sheet basics, custom cell rendering, custom themes, React component usage, interactions, layout

Additional changes

Moved antv-skills-maintainer from .github/skills/antv-skills-maintainer.md to .github/skills/antv-skills-maintainer/SKILL.md (directory-based convention)
Marked antv-skills-maintainer as internal-only in its SKILL.md — it is excluded from README.md and marketplace.json since it is only used for this repository's iteration workflow
Synced docs per antv-skills-maintainer: added antv-s2-expert entry to README.md "Available Skills" and .claude-plugin/marketplace.json

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Create the s2-expert skill for S2 multi-dimensional cross-analysis table development assistance with @antv/s2 packages. Includes query routing rules, code generation guidelines, and reference directory structure for knowledge, type, and examples. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Create English knowledge base files translated and synthesized from Chinese S2 source documentation: - 00-overview.md: S2 introduction, core concepts, architecture, packages - 01-sheet-types.md: PivotSheet and TableSheet usage and comparison - 02-framework-bindings.md: React and Vue component bindings - 03-theme-style.md: Themes, palettes, and style configuration - 04-custom-cell.md: Custom cell rendering, sizing, and header grouping Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Add 6 new knowledge reference files translated from Chinese source docs: - 05-events-interaction.md: Events system, S2Event, interaction config, custom interactions - 06-data-config.md: S2DataConfig structure, fields, meta, formatters - 07-sort.md: Sort methods, sortParams, group sort, custom sort functions - 08-totals.md: Subtotals/grand totals configuration, CalcTotals, aggregation - 09-copy-export.md: Copy/export functionality, clipboard API, CSV export - 10-pagination.md: Pagination config, React integration Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Create reference markdown files with representative code examples extracted from S2 source examples, covering: - pivot-sheet-basic: Grid, tree, and grid-tree PivotSheet modes - table-sheet-basic: Basic TableSheet with frozen rows/columns - custom-cell-render: Custom DataCell, ColCell, and TableDataCell - custom-theme: Built-in themes, custom palette, and full theme schema - react-component-usage: SheetComponent for pivot, table, and editable modes - interaction-examples: Cell selection, events, brush selection, custom interaction - layout-examples: Frozen layout, custom cell sizing, tree collapse config All Chinese comments translated to English. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Co-authored-by: Alexzjt <9548248+Alexzjt@users.noreply.github.com>

skills/s2-expert/SKILL.md

hustcc · 2026-02-25T08:57:18Z

@copilot

skills/antv-skills-maintainer.md 改成 skills/antv-skills-maintainer/SKILL.md
按照 antv-skills-maintainer 去同步下文档。

Co-authored-by: hustcc <7856674+hustcc@users.noreply.github.com>

Copilot · 2026-02-25T09:00:08Z

@copilot

skills/antv-skills-maintainer.md 改成 skills/antv-skills-maintainer/SKILL.md
...

Done in 04ffb7f:

Moved .github/skills/antv-skills-maintainer.md → skills/antv-skills-maintainer/SKILL.md to follow the same convention as other skills.
Synced docs per antv-skills-maintainer instructions:
- Added antv-s2-expert and antv-skills-maintainer entries to README.md "Available Skills" section
- Added both entries to .claude-plugin/marketplace.json plugins array

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

antv-studio.alipay.com
- Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node /home/REDACTED/work/chart-visualization-skills/chart-visualization-skills/node_modules/.bin/vitest run (dns block)
www.weavefox.cn
- Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node /home/REDACTED/work/chart-visualization-skills/chart-visualization-skills/node_modules/.bin/vitest run (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Configure Actions setup steps to set up my environment, which run before the firewall is enabled
Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

hustcc · 2026-02-25T09:17:47Z

@copilot antv-skills-maintainer 不要添加到文档中，这个仅仅是这个仓库迭代需要的。把这一条也写进 antv-skills-maintainer SKILL 描述中。

hustcc · 2026-02-25T09:18:33Z

@copilot antv-skills-maintainer 放到 .github/skills/antv-skills-maintainer 中

Co-authored-by: hustcc <7856674+hustcc@users.noreply.github.com>

Copilot · 2026-02-25T09:19:04Z

@copilot antv-skills-maintainer 不要添加到文档中，这个仅仅是这个仓库迭代需要的。把这一条也写进 antv-skills-maintainer SKILL 描述中。

Done in c500575:

Removed antv-skills-maintainer from both README.md "Available Skills" and .claude-plugin/marketplace.json
Added an "Important" section to skills/antv-skills-maintainer/SKILL.md stating it's internal-only and must not be listed in docs

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

antv-studio.alipay.com
- Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node /home/REDACTED/work/chart-visualization-skills/chart-visualization-skills/node_modules/.bin/vitest run (dns block)
www.weavefox.cn
- Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node /home/REDACTED/work/chart-visualization-skills/chart-visualization-skills/node_modules/.bin/vitest run (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Configure Actions setup steps to set up my environment, which run before the firewall is enabled
Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

…aintainer/ Co-authored-by: hustcc <7856674+hustcc@users.noreply.github.com>

Copilot · 2026-02-25T09:21:38Z

@copilot antv-skills-maintainer 放到 .github/skills/antv-skills-maintainer 中

Moved in df336d9: skills/antv-skills-maintainer/SKILL.md → .github/skills/antv-skills-maintainer/SKILL.md.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

antv-studio.alipay.com
- Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node /home/REDACTED/work/chart-visualization-skills/chart-visualization-skills/node_modules/.bin/vitest run (dns block)
www.weavefox.cn
- Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node /home/REDACTED/work/chart-visualization-skills/chart-visualization-skills/node_modules/.bin/vitest run (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Configure Actions setup steps to set up my environment, which run before the firewall is enabled
Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Initial plan

15207f5

Copilot AI assigned Copilot and Alexzjt Feb 25, 2026

Copilot started work on behalf of Alexzjt February 25, 2026 06:39 View session

Copilot AI and others added 5 commits February 25, 2026 06:42

feat: add s2-expert skill with knowledge, type, and example references

beb337a

Co-authored-by: Alexzjt <9548248+Alexzjt@users.noreply.github.com>

Copilot AI changed the title ~~[WIP] Implement S2 Expert Skill for improved API understanding~~ Add s2-expert skill for S2 multi-dimensional table development Feb 25, 2026

Copilot finished work on behalf of Alexzjt February 25, 2026 07:08

Alexzjt marked this pull request as ready for review February 25, 2026 07:25

Alexzjt changed the title ~~Add s2-expert skill for S2 multi-dimensional table development~~ feat: Add s2-expert skill for S2 multi-dimensional table development Feb 25, 2026

Alexzjt changed the title ~~feat: Add s2-expert skill for S2 multi-dimensional table development~~ feat: add s2-expert skill for S2 multi-dimensional table development Feb 25, 2026

hustcc reviewed Feb 25, 2026

View reviewed changes

skills/s2-expert/SKILL.md Outdated Show resolved Hide resolved

Alexzjt and others added 2 commits February 25, 2026 16:00

chore: rename to antv-s2-expert

73aaf5a

Merge branch 'master' into copilot/implement-s2-expert-skill

c925302

Copilot started work on behalf of hustcc February 25, 2026 08:57 View session

refactor: move antv-skills-maintainer to skills/ directory and sync docs

04ffb7f

Co-authored-by: hustcc <7856674+hustcc@users.noreply.github.com>

Copilot AI changed the title ~~feat: add s2-expert skill for S2 multi-dimensional table development~~ feat: add antv-s2-expert skill and move antv-skills-maintainer to skills/ Feb 25, 2026

Copilot finished work on behalf of hustcc February 25, 2026 09:01

Copilot started work on behalf of hustcc February 25, 2026 09:17 View session

fix: exclude antv-skills-maintainer from docs and add internal-only note

c500575

Co-authored-by: hustcc <7856674+hustcc@users.noreply.github.com>

Copilot finished work on behalf of hustcc February 25, 2026 09:20

Copilot started work on behalf of hustcc February 25, 2026 09:20 View session

refactor: move antv-skills-maintainer to .github/skills/antv-skills-m…

df336d9

…aintainer/ Co-authored-by: hustcc <7856674+hustcc@users.noreply.github.com>

Copilot AI changed the title ~~feat: add antv-s2-expert skill and move antv-skills-maintainer to skills/~~ feat: add antv-s2-expert skill Feb 25, 2026

Copilot finished work on behalf of hustcc February 25, 2026 09:22

chore: 增强 s2-expert 的描述以便唤起

0824177

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: add antv-s2-expert skill#31

feat: add antv-s2-expert skill#31
Copilot wants to merge 12 commits intomasterfrom
copilot/implement-s2-expert-skill

Copilot AI commented Feb 25, 2026 •

edited

Loading

Uh oh!

Uh oh!

hustcc commented Feb 25, 2026

Uh oh!

Copilot AI commented Feb 25, 2026 •

edited

Loading

I tried to connect to the following addresses, but was blocked by firewall rules:

Uh oh!

hustcc commented Feb 25, 2026

Uh oh!

hustcc commented Feb 25, 2026

Uh oh!

Copilot AI commented Feb 25, 2026 •

edited

Loading

I tried to connect to the following addresses, but was blocked by firewall rules:

Uh oh!

Copilot AI commented Feb 25, 2026 •

edited

Loading

I tried to connect to the following addresses, but was blocked by firewall rules:

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

Copilot AI commented Feb 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Structure

SKILL.md

Reference files

Additional changes

Uh oh!

Uh oh!

hustcc commented Feb 25, 2026

Uh oh!

Copilot AI commented Feb 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

I tried to connect to the following addresses, but was blocked by firewall rules:

Uh oh!

hustcc commented Feb 25, 2026

Uh oh!

hustcc commented Feb 25, 2026

Uh oh!

Copilot AI commented Feb 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

I tried to connect to the following addresses, but was blocked by firewall rules:

Uh oh!

Copilot AI commented Feb 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

I tried to connect to the following addresses, but was blocked by firewall rules:

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Copilot AI commented Feb 25, 2026 •

edited

Loading

Copilot AI commented Feb 25, 2026 •

edited

Loading

Copilot AI commented Feb 25, 2026 •

edited

Loading

Copilot AI commented Feb 25, 2026 •

edited

Loading