最初の Skill

複雑な作成プロセスはひとまず忘れて、まずは既存の Skill を使ってみましょうその便利さを体感しましょう。

この記事のデモは Claude Code に基づいています。まだインストールしていない場合は、こちらのClaude Code チュートリアル。

Skill ディレクトリを作成

Skills は~/.claude/skills/（個人グローバル）またはプロジェクトディレクトリ内の.claude/skills/（プロジェクト専用）に配置されます。

この章ではプロジェクトディレクトリでテストします。まずディレクトリ claude-test を作成します:

mkdir claude-test

そのディレクトリに入り、skills のディレクトリとファイルを作成します：

mkdir -p .claude/skills/python-naming-standard

設定ファイル SKILL.md を作成

ディレクトリに SKILL.md を作成します。これは Skill の頭脳であり、Claude にいつそれを使うかを伝えます。

---
name: Python 内部命名规范技能
description: 当用户要求重构、审查或编写 Python 代码时，请参考此规范。
---

## 指令
1. 所有的内部辅助函数必须以 `_internal_` 前缀命名。
2. 如果发现不符合此规则的代码，请自动提出修改建议。
3. 在执行 `claude commit` 前，必须检查此规范。

## 参考示例
- 正确：`def _internal_calculate_risk():`
- 错误：`def _calculate_risk():`

フィールドの要件：

  • name：小文字、数字、ハイフンのみを使用する必要があります（最大 64 文字）
  • description：Skill の簡潔な説明とその使用タイミング（最大 1024 文字）

作成後のファイル構造は次のとおりです：

あなたのプロジェクトは今、次のようになっているはずです：

my-project/
├─ src/
│  └─ test.py              # 项目源码
├─ .claude/
│  ├─ skills/
│  │  └─ hello-world/
│  │     ├─ skill.md       # Skill 定义（YAML + Instructions，机器可执行）
│  │     └─ README.md      # Skill 说明（人类阅读，可选）
│  └─ config.yml           # Claude 项目级配置（可选）
├─ .gitignore
└─ README.md               # 项目整体说明

次に、ターミナルで以下のコマンドを実行して Claude Code を起動します：

claude

タスクを入力します：

ユーザー割引を計算する関数を書いてください。

Claude はインストール済みの Skills をスキャンし、あなたのリクエストが「Python コード作成」に関連していることを検出して、python-naming-standard にマッチします。

それは SKILL.md の要件に従って、次のようなコードを生成します：

def _internal_get_discount(user_score):
    # 计算逻辑...
    return discount

リソースファイルを追加（任意）

さらに、.claude/skills/の下に以下のディレクトリを追加できます：

同じフォルダに追加：

  • examples/：サンプルファイルを格納します。
  • references/：参考ドキュメントを格納します。
  • scripts/：実行可能スクリプトを格納します（例：PDF を処理する Python）。

次に SKILL.md で参照します：

查看示例 commit：./examples/good-commit.txt
运行脚本：使用工具执行 ./scripts/process.py

公式マーケット

自分で作成する以外にも、2025 年末に公開された Agent Skills オープンスタンダードを利用できます：

  • 公式マーケット：アクセスhttps://github.com/anthropics/skillsリポジトリからプリセットされたスキルをダウンロードします（例：React オプティマイザー、SQL チューニングツール）。
  • Skill Creator：Claude に「さっき教えた Docker の設定ロジックを 1 つの Skill にまとめて」と言うと、対応するディレクトリに自動でファイルを生成してくれます。

このリポジトリを Claude Code のプラグインマーケットとして登録できます。Claude Code で以下のコマンドを実行するだけです：

/plugin marketplace add anthropics/skills

その後、/plugin で確認できます：

指定したスキルセットをインストールする手順：

  • プラグインを参照してインストール（Browse and install plugins）

  • anthropic-agent-skills プラグインソースを選択

  • document-skills（ドキュメントスキル）または example-skills（サンプルスキル）を選択

  • 今すぐインストール（Install now）をクリック

上記の 2 種類のプラグインをコマンドで直接インストールすることもできます：

/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

注意：プラグインでインストールした skills のディレクトリは～/claude/plugins/marketplaces/の下にあります。

プラグインのインストールが完了したら、Claude Code を再起動する必要があります。

使用するときは、指示にスキル名を記載するだけで呼び出せます。例えば document-skills プラグインをインストールした後、Claude Code に次のように指示できます：

使用 PDF 技能提取 path/to/some-file.pdf 文件中的表单字段

または PPT を作成します：

创建一个 Agent Skill 的演示文稿

ご覧のとおり、/document-skills:pptx：

が呼び出され、生成が開始されます：

その後、生成されたファイルの場所が表示されます：

その他の拡張