クイックサマリー: scripted-skill-generator は、Agent Skills の「スキルを作るスキル」に定型処理をスクリプト（Python / Node.js）へ切り出す設計を最初から組み込んだオープンソースのスキルです。Agent Skills はオープンな標準仕様のため、Claude Code・GitHub Copilot（VS Code / CLI）・Codex CLI など複数の AI コーディングエージェントで同じスキルを利用できます。
Agent Skillsの課題:「毎回同じ作業」にトークンを使いすぎる
Agent Skills は、作業手順やノウハウをフォルダにまとめておき、必要な時だけ AI に読み込ませる仕組みです。チャット内容から必要なスキルを AI が自動選択して発動するため、毎回指示を書き直す必要がありません。GitHub の公式ドキュメントでも「instructions・scripts・resources をまとめたフォルダ」と定義されており、SKILL.md だけでなくスクリプトの同梱が仕様として認められています。
ただ、スキルを量産していくと新たな課題が見えてきます。SKILL.md に自然言語で書いた手順は、実行のたびに AI がプログラムを組み立て直すため、同じ作業なのに毎回トークンとクレジットを消費するのです。開発元の Zenn 記事（2026年7月公開）でも、「毎回同じ結果でよい作業ほど、AI にその都度考えさせるのは無駄が大きい」という課題意識が出発点として語られています。
この記事でわかることは次の4点です。
- scripted-skill-generator の考え方（定型処理はスクリプト、判断は AI）
- インストール・配置手順と動作確認の方法
- references/ による「スクリプト化の線引き」のカスタマイズ
- 前作 skills-generator との生成結果の違い
本スキルは GitHub で公開されているオープンソースのスキルです（ライセンス条件はリポジトリの記載をご確認ください）。
何ができるか:「スキルを作るスキル」の進化形
scripted-skill-generator は、ひとことで言うと「定型作業はスクリプトに、判断は AI に」という役割分担を最初から組み込んだスキルを生成してくれるスキルです。対応 CLI は Agent Skills 標準に準拠する Claude Code・GitHub Copilot・Codex CLI などで、VS Code でも近年のリリースでエージェント機能の強化が続いています。
主要な機能は次のとおりです。
- スキル生成前に「どこまでスクリプト化するか」「使う言語（Python か Node.js か）」をユーザーに確認
- 生成物は SKILL.md（AI への手順書）＋ scripts/（実行プログラム）＋ 入出力の約束ごとを書いたメモの3点セット
- ファイル作成前に「これから何を作るか」を提示してから書き込む安全設計
- 生成したスキルの構造を後から機械的にチェック可能
インストール・有効化手順
導入は、公開リポジトリをクローンして所定のディレクトリに配置するだけです。ビルドや外部サービスへの登録は不要です。
git clone https://github.com/safubuki/scripted-skill-generator.git
# プロジェクト内の Agent Skills ディレクトリへ配置
cp -r scripted-skill-generator .agents/skills/scripted-skill-generator配置後のフォルダ構成は次のようになります。
.agents/skills/scripted-skill-generator/
├── SKILL.md
├── assets/
│ └── scripted-skill-template.md
├── references/
│ ├── runtime-policy.md
│ ├── script-first-design.md
│ └── script-quality-checklist.md
└── scripts/
└── scripted_skill_tool.pyClaude Code で使う場合は、プロジェクトの .claude/skills/（またはユーザー共通の ~/.claude/skills/）配下に同じフォルダを配置すれば、会話内容に応じて自動発動します。動作確認は、配置後にエージェントへ「◯◯をするスキルを作って」と依頼し、生成前に「スクリプト化する範囲」と「使用言語」の確認が返ってくれば有効化に成功しています。
設定例:references/ でスクリプト化の方針を調整する
このスキルの判断基準は references/ 配下の3つの Markdown ファイルに集約されており、自分のチームの方針に合わせて編集できます。
- script-first-design.md: 何をスクリプトにするかの線引き。「入力と出力の形が決まっている」「データ量が多い」「同じ処理を繰り返す」「プロジェクト独自のルールがある」作業がスクリプト化の対象です
- runtime-policy.md: 言語の優先順位は Python → Node.js → PowerShell / Bash。言語が未導入でも勝手にインストールしないのがデフォルトで、「インストールする / 別言語に切り替える / ファイル生成のみ」をユーザーが選ぶ設計です
- script-quality-checklist.md: 生成スクリプトの安全基準。実行前の内容提示、Windows / Linux 両対応のパス記述、シークレットをログに出さない、出力順の固定などが定義されています
たとえば社内標準が Node.js のチームなら、runtime-policy.md の優先順位を書き換えるだけで生成方針を変更できます。
実開発フローでの活用例:同じ依頼で生成結果を比べる
開発元の記事では、前作 skills-generator と scripted-skill-generator に「package.json を読んでセットアップ手順と依存ライブラリ一覧を自動生成する README 生成スキルを作って」というまったく同じ依頼を出した比較が示されています。前者はすべての手順を SKILL.md に文章で書いたのに対し、後者は package.json の解析部分を extract_package_meta.py というプログラムに切り出しました。実際のスクリプト出力（一部）は次のとおりです。
"install_command": "pnpm install",
"frameworks": ["Next.js", "React"],
"node_version": { "engines": ">=18.17.0" }事実の抽出はスクリプトが毎回同じ形で行い、フレームワークの説明や README の文章トーンは AI が担当する。生成された SKILL.md には「依存名やバージョンを記憶で書かず、スクリプトの出力を根拠にする」と明記されていたとのことで、ハルシネーション対策としても機能しています。
職種別の適用例も考えやすい構造です。Web 開発者なら README 生成やプロジェクト規約チェック、データ分析担当なら毎月のレポート集計（集計・表変換はスクリプト、数字の解釈は AI）、ブログ運営者ならリンク切れ検出や NG 表現の洗い出し（検出はスクリプト、言い回し調整は AI）といった分担が可能です。Claude Code の運用では、CLAUDE.md にプロジェクト指示を置きつつ、繰り返し作業をこのスキル経由でスクリプト化していくと、hooks による自動 lint と合わせて定型作業の AI 依存度を段階的に下げられます。
類似スキル・代替との比較
| ツール名 | 対応CLI | ライセンス | 最終更新 | 特徴 |
|---|---|---|---|---|
| scripted-skill-generator | Claude Code / GitHub Copilot / Codex CLI 等 | リポジトリで確認 | 2026年7月 | 定型処理のスクリプト化を組み込んだスキル生成。言語選択・安全確認つき |
| skills-generator（前作） | 同上 | リポジトリで確認 | 2026年 | Agent Skill 全般の作成・改善・診断。手順はすべて自然言語で記述 |
| skill-creator（Anthropic公式） | Claude Code / Claude | 公式リポジトリで確認 | 随時更新 | Anthropic が公開する公式のスキル作成支援スキル。汎用的な雛形生成 |
公式の skill-creator が汎用の雛形生成に強い一方、scripted-skill-generator は「トークン消費を抑えたい」「実行結果を毎回同じにしたい」という運用課題に特化している点が差別化ポイントです。
注意点・制約・セキュリティ
- 実行可能なスクリプトを含む点に注意: スキルにプログラムを同梱できるということは、ファイル削除・外部送信・シークレット読み取りのリスクも伴います。本スキル自体は「実行前に内容を提示する」「無断で言語をインストールしない」設計ですが、生成されたスクリプトのレビューは省略しないことを推奨します
- トークン削減効果は定量測定前: 作者自身が「どれくらい効くかはこれから測って確かめたい」と明言しており、削減幅を保証するデータは現時点でありません
- 向かない用途: 要件が固まっていない設計作業、一度きりの小さな作業、状況で答えが変わるレビューなどは、スクリプト化せず AI に任せたままにする方針がスキル内でも定義されています
- 野良スキル全般の話として、出所不明のスキルを導入する際は SKILL.md と scripts/ の中身を必ず確認してください
まとめ
要点は次の3つです。
- scripted-skill-generator は「定型処理はスクリプト、判断は AI」という役割分担を最初から組み込んだスキルを生成するオープンソースのスキル
- 導入はリポジトリをクローンして
.agents/skills/（Claude Code なら.claude/skills/）に置くだけ。references/ の編集で運用方針を調整できる - 同じ依頼でも前作とは生成物の構造が変わり、事実抽出の再現性とトークン節約が期待できる（効果の定量値は今後の検証待ち）
毎回同じ作業を AI にやらせていると感じている方は、まず1つ、README 生成のような「入出力が決まった作業」から試してみる価値があると考えられます。Agent Skills の仕様詳細は、Claude Code・GitHub Copilot・Codex の各公式ドキュメントも併せて参照してください。
コメント