antvis/antv-skills-maintainer

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

1. 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:

1. Scan skills/ directory to list all available skills.
2. Read each skill's SKILL.md frontmatter (name, description).
3. Compare with the current ## Available Skills section in README.md.
4. Add entries for new skills, update entries for changed skills, remove entries for deleted skills.
5. Preserve the section's existing formatting style.

2. .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:

1. Scan skills/ directory to list all available skills.
2. Read each skill's SKILL.md frontmatter (name, description).
3. Compare with the current plugins array in .claude-plugin/marketplace.json.
4. Add entries for new skills, update description for changed skills, remove entries for deleted skills.
5. 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