Claude Agent Skills実践ガイド — SKILL.mdカスタムSkill作成からAPI統合、Progressive Disclosureまで

import Anthropic from "@anthropic-ai/sdk";
import { writeFileSync } from "fs";

const client = new Anthropic();

// 1. ファイルをアップロード（必要な場合）
const file = await client.beta.files.upload(
  { file: new File([buffer], "sales.xlsx") },
  { betas: ["files-api-2025-04-14"] }
);

// 2. Skills有効化してメッセージ送信
const response = await client.beta.messages.create(
  {
    model: "claude-sonnet-4-6",
    max_tokens: 4096,
    tools: [{ type: "code_execution_20250825", name: "code_execution" }],
    container: {
      files: [file.id],
      skills: [
        { type: "anthropic", skill_id: "xlsx", version: "latest" }
      ],
    },
    messages: [
      { role: "user", content: "このExcelデータを分析し、売上レポートをPDFで作成してください" }
    ],
  },
  {
    betas: [
      "code-execution-2025-08-25",
      "skills-2025-10-02",
      "files-api-2025-04-14",
    ],
  }
);

// 3. 生成ファイルをダウンロード
for (const block of response.content) {
  if (block.type === "file") {
    const dl = await client.beta.files.download(block.file.id, {
      betas: ["files-api-2025-04-14"],
    });
    writeFileSync("report.pdf", Buffer.from(await dl.arrayBuffer()));
  }
}

---
name: coding-standards-checker
description: プロジェクトのTypeScriptコードがチームのコーディング規約に準拠しているかチェックし、違反箇所を修正案付きで報告するSkill。コードレビュー依頼や規約チェック時に使用する。
---

# コーディング規約チェッカー

## 手順

1. 対象ファイルのTypeScriptコードを読み取る
2. `rules/` ディレクトリ内の規約定義と照合する
3. 違反箇所をリスト化し、修正案を提示する

## ルール一覧

- 関数は30行以内に収める
- any型の使用を禁止する
- エラーハンドリングではカスタムError classを使用する

## 出力フォーマット

| ファイル | 行 | ルール | 修正案 |
|---------|---|--------|--------|

import Anthropic from "@anthropic-ai/sdk";
import { createReadStream } from "fs";

const client = new Anthropic();

// 1. カスタムSkillをアップロード（ZIPまたは個別ファイル）
const skill = await client.beta.skills.create(
  {
    display_title: "コーディング規約チェッカー",
    files: [
      await Anthropic.toFile(
        createReadStream("./my-skill/SKILL.md"),
        "my-skill/SKILL.md"
      ),
      await Anthropic.toFile(
        createReadStream("./my-skill/rules/typescript.json"),
        "my-skill/rules/typescript.json"
      ),
    ],
  },
  { betas: ["skills-2025-10-02"] }
);

console.log(skill.id); // "skill_01AbCdEfGh..."

// 2. プリビルト + カスタムSkillを組み合わせてリクエスト
const response = await client.beta.messages.create(
  {
    model: "claude-sonnet-4-6",
    max_tokens: 4096,
    tools: [{ type: "code_execution_20250825", name: "code_execution" }],
    container: {
      skills: [
        { type: "custom", skill_id: skill.id },
        { type: "anthropic", skill_id: "pdf", version: "latest" },
      ],
    },
    messages: [
      {
        role: "user",
        content: "src/配下のコードを規約チェックし、結果をPDFレポートにまとめてください",
      },
    ],
  },
  {
    betas: [
      "code-execution-2025-08-25",
      "skills-2025-10-02",
      "files-api-2025-04-14",
    ],
  }
);