AntV Skills Maintainer
This skill ensures that all documentation and configuration files remain in sync whenever a skill is added or updated in this repository.
Important
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.
When to Apply
Apply this skill automatically after every code change — especially when:
-
A new skill directory is added under skills/
-
An existing skill's SKILL.md is modified (name, description, capabilities)
-
A skill is removed or deprecated
What to Keep in Sync
- README.md — "Available Skills" Section
The ## Available Skills section in README.md must list every skill under skills/ with:
-
An appropriate emoji icon
-
The skill name (bold, matching the directory name)
-
A one-line description matching the skill's SKILL.md frontmatter description field
-
A short paragraph elaborating on the skill's capabilities
Format:
- 🔧 skill-name: One-line description from SKILL.md frontmatter.
Skill Display Name elaboration paragraph...
Steps:
-
Scan skills/ directory to list all available skills.
-
Read each skill's SKILL.md frontmatter (name , description ).
-
Compare with the current ## Available Skills section in README.md .
-
Add entries for new skills, update entries for changed skills, remove entries for deleted skills.
-
Preserve the section's existing formatting style.
- .claude-plugin/marketplace.json — Plugins Array
The plugins array in .claude-plugin/marketplace.json must contain an entry for every skill under skills/ .
Entry format:
{ "name": "skill-name", "description": "Description from SKILL.md frontmatter.", "source": "./", "strict": false, "skills": [ "./skills/skill-name" ] }
Steps:
-
Scan skills/ directory to list all available skills.
-
Read each skill's SKILL.md frontmatter (name , description ).
-
Compare with the current plugins array in .claude-plugin/marketplace.json .
-
Add entries for new skills, update description for changed skills, remove entries for deleted skills.
-
Keep the JSON properly formatted and valid.
Execution Checklist
After any skill-related code change, run through this checklist:
-
All skill directories in skills/ are listed in README.md under ## Available Skills
-
All skill descriptions in README.md match the corresponding SKILL.md frontmatter
-
All skill directories in skills/ have a corresponding entry in .claude-plugin/marketplace.json
-
All description fields in marketplace.json match the corresponding SKILL.md frontmatter
-
No stale entries exist in either README.md or marketplace.json for removed skills
-
marketplace.json remains valid JSON after changes