mcpField
F
fix-frontmatter

fix-frontmatter

github.com/dailybothqテスト・品質2349 回インストール2 日前に更新
リポジトリ

fix-frontmatter について

`SKILL.md` を管理し、CI の検証エラーに対応する開発者向けスキルです。検証スクリプトで前置メタデータの問題を特定し、必要な修正を行って再検証します。

主な機能

  1. 01前置メタデータ検証スクリプトの実行
  2. 02規則に沿った名前とバージョン表記の修正
  3. 03homepage を documentation_url に置換
  4. 04区切り記号と必須キーの確認
  5. 05検証に合格するまで再実行

活用シーン

  1. 01SKILL.md の追加・編集後の形式確認
  2. 02CI の前置メタデータ検証エラーへの対応
  3. 03skills/ 内で指摘されたファイルの修正

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/dailybothq/deepworkplan-skill --skill fix-frontmatter

インストール後、Claude Code で/fix-frontmatterを入力して読み込まれたか確認します。

詳細

Frontmatter の修正

目標

skills/ 以下のすべての SKILL.md を CI が適用する frontmatter の仕様に準拠させ、scripts/validate-frontmatter.py が合格するようにします。

使用する場面

SKILL.md を追加または編集した後、あるいは CI の「SKILL.md frontmatter validation」ジョブが失敗したときに使用します。

手順

  1. python3 scripts/validate-frontmatter.py を実行し、報告された問題をすべて確認します。
  2. 指摘されたファイルごとに、frontmatter を修正します。
    • name: → kebab-case にし、deepworkplan で始めます（例：deepworkplan-create）
    • version: → 引用符で囲んだ SemVer にします（"2.8.0"）
    • homepage: を documentation_url: に置き換えます
    • --- の区切りと必須キーが存在することを確認します
  3. OK: all N SKILL.md file(s) validated と表示されるまで、バリデーターを再実行します。

検証

python3 scripts/validate-frontmatter.py が終了コード 0 で終了します。

注意事項

チェックに合格するために version: の番号を編集してはいけません。引用符または形式だけを修正してください。バージョン番号は auto-release.yml ボットが管理します（AGENTS.md §4）。バリデーターがスキャンするのは skills/ のみです。.agents/skills/* は CI のチェック対象ではありませんが、同じスタイルに従います。

コメント

Markdown 対応