yaml-validator について
yaml-validatorは、YAMLファイルの構文、構造、スキーマ準拠を確認するスキルです。よくあるエラーへの対処法や、プロジェクト向けの設定例も扱います。
主な機能
- 01構文・構造・スキーマの検証
- 02yamllintコマンド例
- 03よくあるYAMLエラーへの対処
- 04プロジェクト用設定の提案
- 05GitHub Actionsチェック項目
活用シーン
- 01コミット前のYAMLファイル確認
- 02インデントや重複キーの調査
- 03プロジェクト単位のyamllint設定
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ d-o-hub/ rust-self-learning-memory --skill yaml-validatorインストール後、Claude Code で/yaml-validatorを入力して読み込まれたか確認します。
詳細
YAML バリデーター
YAML ファイルの構文、構造、スキーマへの準拠を検証します。
よくある問題
| 問題 | 修正方法 |
|---|---|
| タブとスペースの混在 | インデントをスペース 2 個に統一します |
| コロンの欠落 | キーの後に : を追加します |
| 特殊文字が引用符で囲まれていない | :, {, }, [, ] を含む文字列を引用符で囲みます |
| キーの重複 | 削除するか統合します |
| ブール値に見える文字列 | yes, no, on, off を引用符で囲みます |
| 末尾の空白 | sed -i 's/[[:space:]]*$//' で削除します |
検証コマンド
# Install yamllint
pip install yamllint
# Validate single file
yamllint file.yml
# Check all YAML files
yamllint .
# Python fallback
python3 -c "import yaml; yaml.safe_load(open('file.yml'))"
プロジェクトの .yamllint 設定
プロジェクトのルートに .yamllint.yml を作成し、インデントをスペース 2 個、行の最大長を 120 文字に設定して、末尾の空白とキーの重複に関するルールを有効にします。
GitHub Actions チェックリスト
- 有効な
on:トリガー(push、pull_request、schedule) - 正しい
runs-onの値(ubuntu-latest、macos-latest) - 適切な
steps:リスト構造 - 最新のアクションバージョン(v1/v2 ではなく v3/v4)
ベストプラクティス
DO
- インデントにはスペース 2 個を使用します
- 特殊文字を含む文字列は引用符で囲みます
- コミット前に検証します
- 行の長さを 120 文字未満に保ちます
- ファイルの末尾に改行を入れます
DON'T
- インデントにタブを使用しないでください
- 末尾に空白を残さないでください
- キーを重複させないでください
- YAML 1.1 と 1.2 の機能を混在させないでください
コメント
Markdown 対応