Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

コロンを含むスキル説明（例: "Triggers include: X, Y, Z"）が SKILL.md フロントマターから読み込みに失敗する問題を修正

原文（英語） ​

Fixed skill descriptions with colons (e.g., "Triggers include: X, Y, Z") failing to load from SKILL.md frontmatter

概要 ​

SKILL.md ファイルのフロントマターにある description: フィールドにコロン（:）が含まれていると、YAMLのパースエラーによりスキルが読み込まれない問題がありました。この修正により、説明文にコロンが含まれていても正しく読み込まれるようになります。

基本的な使い方 ​

コロンを含む説明文は引用符で囲むことで解決できましたが、修正後はより柔軟に記述できます。

yaml
---
# 修正前: コロンがあると読み込みに失敗
description: トリガー: コミット前, プッシュ前

# 修正後: コロンを含む説明も正しく処理される
description: "トリガー: コミット前, プッシュ前"
---

実践例 ​

コロンを含む説明のスキル定義 ​

yaml
---
name: code-review
description: "コードレビュースキル: PR作成時とコミット前に自動実行"
triggers:
  - pre-commit
  - pull-request
---

## コードレビュースキル

このスキルはコードの品質を自動的にチェックします...

複数の条件を説明するスキル ​

yaml
---
name: deploy-check
description: "デプロイ前チェック: 環境変数, テスト, ビルドを検証"
---

## デプロイ前チェックスキル

本番環境へのデプロイ前に必要な検証を実行します...

英語のコロンを含む説明 ​

yaml
---
name: git-helper
description: "Git workflow helper: includes commit, push, and PR creation"
---

## Git Helper Skill

...

注意点 ​

  • YAML仕様では、コロンを含む文字列は引用符で囲む必要があります。修正後も引用符の使用を推奨します
  • description: フィールド以外の他のフロントマターフィールドでも同様の問題が起きる可能性があります
  • 既存のスキルがコロンを含む説明で動作していなかった場合、v2.1.69以降で自動的に修正されます

関連情報 ​