PyTorchのskill-writerスキルでClaude Code用スキルを作成する方法

Claude Codeのスキルを作成したいけれど、どこから始めればよいかわからない。SKILL.mdの書き方やフロントマターの要件がわかりにくい。そんな経験はありませんか？

この記事では、PyTorchリポジトリで公開されているskill-writerスキルを使って、Claude Code用のAgent Skillを効率的に作成する方法を解説します。

このスキルは何をしてくれるのか

skill-writerは、Claude Code向けAgent Skillの作成をステップバイステップでガイドするスキルです：

• スキルのスコープ決定と保存場所の選択
• SKILL.mdのフロントマター（name/description）の書き方
• 効果的なdescriptionの作成（トリガー精度に直結）
• ディレクトリ構成とサポートファイルの設計
• バリデーションチェックリストとデバッグ手順

初めてスキルを作成する開発者から、既存スキルの改善を検討している方まで幅広く活用できます。

インストール方法

前提条件

• Claude Codeがインストール済みであること

インストールコマンド

Copyclaude mcp add github.com/pytorch/pytorch/tree/main/.claude/skills/skill-writer

使い方

基本的な使い方

新しいスキルを作成するには：

Copy新しいClaude Codeスキルを作成したい

skill-writerが10段階のプロセスでガイドします。

スキルの保存場所

• 個人用: ~/.claude/skills/ - 個人のワークフローや実験用
• プロジェクト用: .claude/skills/ - チーム共有、gitにコミット可能

descriptionの書き方

descriptionはスキルのトリガー精度に直結するため、以下の公式で記述します：

Copy[何をするか] + [いつ使うか] + [キートリガー]

良い例：

Copydescription: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.

バリデーション

作成後は以下をチェックします：

• SKILL.mdの存在とフロントマターの妥当性
• nameの命名規則（小文字、ハイフン区切り、64文字以内）
• descriptionの具体性（1024文字以内）
• 実際のクエリでトリガーされるか確認

知っておくべき注意点

nameはディレクトリ名と一致が必要

フロントマターのnameフィールドは、スキルのディレクトリ名と一致している必要があります。大文字やアンダースコアは使えません。

allowed-toolsで権限制御が可能

読み取り専用のスキル（コードレビューなど）にはallowed-tools: Read, Grep, Globを設定して、書き込み権限を制限できます。

スキルが発火しない場合

descriptionにファイル拡張子（.pdf、.xlsx等）や、ユーザーが使いそうなフレーズ（「分析して」「抽出して」等）を追加してください。claude --debugでデバッグも可能です。

まとめ

skill-writerを使うと、Claude Code用スキルの作成をバリデーション付きで進められます。特にdescriptionの書き方がスキルの使い勝手に直結するため、トリガー条件を具体的に記述することが重要です。

詳細な仕様やオプションは、スキル詳細ページをご確認ください。

関連リンク

→ skill-writer スキル詳細