1仕組みと動作原理

メタスキル：「skill の作り方」自体のガイドであり、コア成果物は一連のプロセス仕様＋3 つのローカル Python ツール。

skills/skill-creator/SKILL.md

Skill creation involves these steps:

ここで行われていること：skill の作成を 6 つの実行可能なステップに分解している。

最優先原則は「簡潔さ（conciseness）」：コンテキストウィンドウは共有リソースであり、モデルがまだ知らない情報のみを補足する。

skills/skill-creator/SKILL.md

The context window is a public good.

ここで行われていること：トークンコストを設計上の制約に引き上げ、すべての文節の必要性を精査することを求めている。

タスクの脆弱性に応じて自由度を選択：変化の多いシナリオにはテキスト指示（高自由度）、壊れやすいワークフローにはパラメータ付きスクリプト（低自由度）。

skills/skill-creator/SKILL.md

**High freedom (text-based instructions)**: Use when multiple approaches are valid, decisions depend on context, or heuristics guide the approach.

ここで行われていること：「狭い橋にはガードレールを設け、開けた野原では自由に歩かせる」という例えを用いて実装形態を決定している。

skill ディレクトリ構造の規定：必須の SKILL.md（frontmatter＋本文）、任意の scripts/references/assets の 3 種のリソース。

skills/skill-creator/SKILL.md

Every skill consists of a required SKILL.md file and optional bundled resources:

ここで行われていること：標準ディレクトリ構造を定義し、3 種類のリソースの用途を個別のセクションで説明している。

プログレッシブディスクロージャーによる 3 段階読み込み：metadata は常にコンテキスト内に常駐、本文はトリガー時に読み込み、リソースは必要に応じてオンデマンドで読み込み。

skills/skill-creator/SKILL.md

Skills use a three-level loading system to manage context efficiently:

ここで行われていること：詳細を SKILL.md の外部へ切り出す理由を説明している。

ステップ 3 で init_skill.py を使用してテンプレートディレクトリ（SKILL.md＋scripts/references/assets のサンプルファイル）を生成。

skills/skill-creator/SKILL.md

scripts/init_skill.py <skill-name> --path <output-directory>

ここで行われていること：スキャフォールディングコマンドであり、実際に付属スクリプトを実行する。

ステップ 5 で package_skill.py を使用して検証を実行後、.skill（zip 形式）にパッケージ化。

skills/skill-creator/SKILL.md

scripts/package_skill.py <path/to/skill-folder>

ここで行われていること：デリバリー工程であり、パッケージ化の前に自動でバリデーションを実行する。

コンテキストの汚染を防ぐため、README/INSTALLATION_GUIDE/CHANGELOG などの雑多なドキュメントの同梱を明確に禁止。

skills/skill-creator/SKILL.md

Do NOT create extraneous documentation or auxiliary files, including:

ここで行われていること：「何を書いてはいけないか」もハードルールとして明文化している。

2コア機能

01Skill ディレクトリ構造仕様：SKILL.md（frontmatter＋本文）＋ scripts/references/assets

026 ステップの作成ワークフロー：理解 → 計画 → 初期化 → 編集 → パッケージ化 → 反復

03スキャフォールド生成：init_skill.py によるディレクトリ作成、SKILL.md テンプレート＋3 つのサンプルリソースの書き込み

04バリデータ：quick_validate.py による frontmatter フィールドのホワイトリスト、命名規則、説明文の長さのチェック

05パッケージ化と配布：package_skill.py による検証通過後の .skill（zip）へのアーカイブ化

06デザインパターンリファレンス：output-patterns.md（テンプレート／例）および workflows.md（順次／条件分岐ワークフロー）

07プログレッシブディスクロージャーの指針：SKILL.md 本文を 500 行以内に抑え、詳細は参照ファイルへ外出し

08自由度選定の指針：タスクの脆弱性に応じたテキスト指示／パラメータ付きスクリプト／固定スクリプトの選択

3外部依存関係

Kind	Dependency / Endpoint
cli	python3
package	PyYAML（解析 frontmatter）

4推奨統制措置と判定根拠

安全運用のための推奨統制措置

Agent 向け

段階的・都度認可、サンドボックス推奨

管理者向け

承認フロー、ロールバック可能、全履歴監査

判定根拠（ファイルパスと抜粋）

scripts/: ローカルスクリプトまたはコマンドの実行: scripts/init_skill.py
本地工作目录: ファイルの読み書きと成果物の出力: skill ディレクトリおよび SKILL.md の作成

監査ノート： 判定 🔵 blue：3 つのローカル Python スクリプトを内包し、ディレクトリ作成、テンプレートファイル書き込み、zip パッケージ化などのローカル読み書きを実行（§3 ディスク書き込み 10 項目が init_skill.py/package_skill.py に該当）。§3 においてネットワークリクエスト、認証情報読み取り、危険フラグはなし。リスク警告：blue（通常利用）。スクリプトはユーザーから指定されたパスに従ってファイルシステムに書き込みを行うため、対象ディレクトリに注意してください。

5二重目の独立検証

[ok] 文件面核对 — §1 共 7 个文件：SKILL.md、LICENSE.txt、2 个 references、3 个 scripts，与 internal_assets 一致。
[ok] 脚本执行真伪 — §3「执行外部程序」无命中（脚本由模型按 SKILL.md 指示调用）；三个脚本源码实读确认存在。
[ok] 凭证读取反例 — §3 两条凭证命中经回原文核对为 SKILL.md 的 'challenge each' 文本与示例 'token validation middleware'，非 env/凭据读取，故 credential_reads 判空。
[ok] 写盘复核 — §3 写盘 10 条命中 init_skill.py（mkdir/write_text/chmod）与 package_skill.py（mkdir/zipf.write），与 file_writes 一致。
[ok] 网络与注入面 — §3 无 URL、无网络请求命中；注入面仅剩用户输入经 yaml.safe_load 解析的语义校验缺口（设计边界）。
[ok] 档位判定复核 — 本地脚本 + 本地读写、无网络无凭证 → 🔵 blue 成立。