$npx -y skills add antvis/chart-visualization-skills --skill antv-skills-maintainerAutomatically sync documentation and configuration after any skill is added or updated. Triggers on every AI code execution to keep README Available Skills and .claude-plugin/marketplace.json up to date.
| 1 | # AntV Skills Maintainer |
| 2 | |
| 3 | This skill ensures that all documentation and configuration files remain in sync whenever a skill is added or updated in this repository. |
| 4 | |
| 5 | ## Important |
| 6 | |
| 7 | The `antv-skills-maintainer` skill is **internal-only** — it is used solely for this repository's iteration workflow. Do **not** add it to `README.md` "Available Skills" or `.claude-plugin/marketplace.json`. Only user-facing skills should appear in those files. |
| 8 | |
| 9 | ## When to Apply |
| 10 | |
| 11 | Apply this skill automatically after **every code change** — especially when: |
| 12 | |
| 13 | - A new skill directory is added under `skills/` |
| 14 | - An existing skill's `SKILL.md` is modified (name, description, capabilities) |
| 15 | - A skill is removed or deprecated |
| 16 | |
| 17 | ## What to Keep in Sync |
| 18 | |
| 19 | ### 1. README.md — "Available Skills" Section |
| 20 | |
| 21 | The `## Available Skills` section in `README.md` must list every skill under `skills/` with: |
| 22 | |
| 23 | - An appropriate emoji icon |
| 24 | - The skill **name** (bold, matching the directory name) |
| 25 | - A one-line description matching the skill's `SKILL.md` frontmatter `description` field |
| 26 | - A short paragraph elaborating on the skill's capabilities |
| 27 | |
| 28 | **Format:** |
| 29 | |
| 30 | ```markdown |
| 31 | - 🔧 **skill-name**: One-line description from SKILL.md frontmatter. |
| 32 | |
| 33 | `Skill Display Name` elaboration paragraph... |
| 34 | ``` |
| 35 | |
| 36 | **Steps:** |
| 37 | |
| 38 | 1. Scan `skills/` directory to list all available skills. |
| 39 | 2. Read each skill's `SKILL.md` frontmatter (`name`, `description`). |
| 40 | 3. Compare with the current `## Available Skills` section in `README.md`. |
| 41 | 4. Add entries for new skills, update entries for changed skills, remove entries for deleted skills. |
| 42 | 5. Preserve the section's existing formatting style. |
| 43 | |
| 44 | ### 2. `.claude-plugin/marketplace.json` — Plugins Array |
| 45 | |
| 46 | The `plugins` array in `.claude-plugin/marketplace.json` must contain an entry for every skill under `skills/`. |
| 47 | |
| 48 | **Entry format:** |
| 49 | |
| 50 | ```json |
| 51 | { |
| 52 | "name": "skill-name", |
| 53 | "description": "Description from SKILL.md frontmatter.", |
| 54 | "source": "./", |
| 55 | "strict": false, |
| 56 | "skills": [ |
| 57 | "./skills/skill-name" |
| 58 | ] |
| 59 | } |
| 60 | ``` |
| 61 | |
| 62 | **Steps:** |
| 63 | |
| 64 | 1. Scan `skills/` directory to list all available skills. |
| 65 | 2. Read each skill's `SKILL.md` frontmatter (`name`, `description`). |
| 66 | 3. Compare with the current `plugins` array in `.claude-plugin/marketplace.json`. |
| 67 | 4. Add entries for new skills, update `description` for changed skills, remove entries for deleted skills. |
| 68 | 5. Keep the JSON properly formatted and valid. |
| 69 | |
| 70 | ## Execution Checklist |
| 71 | |
| 72 | After any skill-related code change, run through this checklist: |
| 73 | |
| 74 | - [ ] All skill directories in `skills/` are listed in `README.md` under `## Available Skills` |
| 75 | - [ ] All skill descriptions in `README.md` match the corresponding `SKILL.md` frontmatter |
| 76 | - [ ] All skill directories in `skills/` have a corresponding entry in `.claude-plugin/marketplace.json` |
| 77 | - [ ] All `description` fields in `marketplace.json` match the corresponding `SKILL.md` frontmatter |
| 78 | - [ ] No stale entries exist in either `README.md` or `marketplace.json` for removed skills |
| 79 | - [ ] `marketplace.json` remains valid JSON after changes |