antv-skills-maintainer について
AntV skills リポジトリの保守に使う内部向けスキルです。コード変更後に、README のスキル一覧と marketplace のプラグイン項目をディレクトリやメタデータに合わせます。
主な機能
- 01スキルディレクトリと README.md の照合
- 02frontmatter との説明文の同期
- 03marketplace.json のプラグイン項目更新
- 04古い項目と JSON 形式の確認
活用シーン
- 01スキル追加後のリポジトリ一覧更新
- 02説明変更後のメタデータ同期
- 03スキル廃止時の古い項目の削除
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ antvis/ chart-visualization-skills --skill antv-skills-maintainerインストール後、Claude Code で/antv-skills-maintainerを入力して読み込まれたか確認します。
詳細
AntV スキルメンテナー
このスキルは、リポジトリ内でスキルが追加または更新されるたびに、すべてのドキュメントファイルと設定ファイルの内容が同期された状態に保たれるようにします。
重要
antv-skills-maintainer スキルは内部専用です。このリポジトリのイテレーションワークフローでのみ使用します。README.md の「Available Skills」や .claude-plugin/marketplace.json には追加しないでください。これらのファイルには、ユーザー向けのスキルのみを掲載します。
適用するタイミング
コードを変更するたびに、特に次の場合はこのスキルを自動的に適用してください。
skills/の下に新しいスキルディレクトリが追加されたとき- 既存のスキルの
SKILL.md(名前、説明、機能)が変更されたとき - スキルが削除または非推奨になったとき
同期する項目
1. README.md —「Available Skills」セクション
README.md の ## Available Skills セクションには、skills/ の下にあるすべてのスキルを次の内容とともに記載する必要があります。
- 適切な絵文字アイコン
- スキルの名前(太字で、ディレクトリ名と一致させる)
- スキルの
SKILL.mdフロントマターのdescriptionフィールドと一致する1行の説明 - スキルの機能を補足する短い段落
形式:
- 🔧 **skill-name**: One-line description from SKILL.md frontmatter.
`Skill Display Name` elaboration paragraph...
手順:
skills/ディレクトリを確認し、利用可能なすべてのスキルを一覧にします。- 各スキルの
SKILL.mdフロントマター(name、description)を読み取ります。 - 現在の
README.mdの## Available Skillsセクションと照合します。 - 新しいスキルの項目を追加し、変更されたスキルの項目を更新し、削除されたスキルの項目を削除します。
- セクションの既存の書式スタイルを維持します。
2. .claude-plugin/marketplace.json — Plugins 配列
.claude-plugin/marketplace.json の plugins 配列には、skills/ の下にあるすべてのスキルの項目を含める必要があります。
項目の形式:
{
"name": "skill-name",
"description": "Description from SKILL.md frontmatter.",
"source": "./",
"strict": false,
"skills": [
"./skills/skill-name"
]
}
手順:
skills/ディレクトリを確認し、利用可能なすべてのスキルを一覧にします。- 各スキルの
SKILL.mdフロントマター(name、description)を読み取ります。 .claude-plugin/marketplace.jsonの現在のplugins配列と照合します。- 新しいスキルの項目を追加し、変更されたスキルの
descriptionを更新し、削除されたスキルの項目を削除します。 - JSON の書式を適切に保ち、有効な状態にします。
実行チェックリスト
スキルに関するコードを変更した後は、次のチェックリストを確認してください。
-
skills/内のすべてのスキルディレクトリが、README.mdの## Available Skillsに記載されている -
README.md内のすべてのスキルの説明が、対応するSKILL.mdのフロントマターと一致している -
skills/内のすべてのスキルディレクトリに、.claude-plugin/marketplace.json内の対応する項目がある -
marketplace.json内のすべてのdescriptionフィールドが、対応するSKILL.mdのフロントマターと一致している - 削除されたスキルの古い項目が、
README.mdとmarketplace.jsonのどちらにも残っていない - 変更後も
marketplace.jsonが有効な JSON である
コメント
Markdown 対応