antv-skills-maintainer

SKILL.md

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
Weekly Installs
26
GitHub Stars
39
First Seen
10 days ago
Installed on
gemini-cli26
github-copilot26
codex26
amp26
cline26
kimi-cli26