yaml-master について
yaml-master は YAML 設定ファイルを確認・編集するスキルです。構文や構造の問題を見つけ、意味を変えない最小限の修正と、次に行う検証手順を提示します。
主な機能
- 01YAML 構文と位置の確認
- 02フォーマットの統一
- 03対象システムに沿った構造検証
- 04危険な YAML パターンの検出
- 05最小パッチと検証チェックリスト
活用シーン
- 01ワークフローのインデントや構文エラーの修正
- 02Kubernetes や Compose 設定の確認
- 03JSON 設定の安全な YAML 変換
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/yaml-masterを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
assets/README.mdreferences/README.mdSKILL.full.mdscripts/README.md詳細
YAML マスター
プロアクティブな YAML インテリジェンス：構文を検証し、一貫した書式を適用して、設定ファイルをスキーマに準拠した状態に保ちます（Kubernetes、GitHub Actions、Docker Compose など）。
概要
このスキルは、.yml／.yaml ファイルを扱う際に有効になり、構造上の問題（インデント、アンカー、型の不一致など）を早期に検出し、CI／設定ツールで問題が起きないように、安全で最小限の編集を行います。
前提条件
- 確認対象の YAML ファイルと、想定される用途（例：Kubernetes、GitHub Actions、Compose）
- 関連するスキーマや制約（利用可能な場合）
- ファイルを編集する権限（またはパッチを提案する権限）
手順
- YAML 構文を解析・検証し、最初に問題が発生する箇所とその位置を特定します。
- 意味を変えずに書式（インデント、引用符）を統一します。
- 対象システムの要件（キー、型、必須フィールド）に照らして構造を検証します。
- リスクのあるパターン（重複キー、曖昧なスカラー、不適切なアンカーの使用）を特定します。
- 最小限のパッチと、次に実行する内容を示す簡潔な検証チェックリストを出力します。
出力
- 最小限の差分で修正した YAML
- 見つかった問題の簡潔な一覧（構文、スキーマ、ベストプラクティスの分類）
- 対象に応じた検証コマンド（例：
kubectl apply --dry-run=client、CI リント）
エラー処理
- スキーマや対象システムが不明な場合は、対象システムを確認し、まず構文のみを修正します。
- YAML が有効でもツールで失敗する場合は、後続処理で発生した正確なエラーを提示し、要件との不整合を解消します。
例
例：インデント／構文エラーの修正
- 入力：
steps:ブロックのインデントが誤っているワークフロー。 - 出力：インデントを修正し、影響を受けたジョブ／ステップを説明します。
例：JSON から YAML への安全な変換
- 入力：JSON 形式の設定データ。
- 出力：型の予期しない解釈を避けるため、必要に応じて明示的に引用符を付けた YAML。
リソース
- 詳細ガイド全文（参照用）：
${CLAUDE_SKILL_DIR}/references/SKILL.full.md - YAML 仕様：https://yaml.org/spec/
- GitHub Actions ワークフロー構文：https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions
コメント
Markdown 対応