# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17
# リソース: [skill_init.py、スキル テーブル]

ANTHROPIC / AGENTSKILLS.IO スキル標準
------------------------------------------

現在: 2026-03-12

Anthropic と Agentskills.io は、
Claude Code、Codex CLI、Cursor、ChatGPT によって提供される AI スキル
他のプラットフォームもサポートされています。この規格により許可されるのは、
プラットフォーム間でスキルを配布してインストールします。

BACH はこの標準をネイティブにサポートしており、既存のスキルを使用できます
Anthropic 互換フォーマットにエクスポートします。


標準ディレクトリ構造
-----------------------------
Anthropic 互換スキルは、次の構造を持つフォルダです。

  私のスキル/
  +-- SKILL.md # メイン定義 (必須)
  +-- scripts/ # 実行可能スクリプト (オプション)
  |   +-- setup.sh
  |   +-- run.py
  +-- 参照/ # 参照ドキュメント (オプション)
  |   +-- コア概要.md
  |   +-- 機能-api.md
  |   +-- ベストプラクティス-testing.md
  |   +-- Advanced-caching.md
  +-- 資産/ # 静的ファイル (オプション)
      +-- ロゴ.png
      +-- config-template.json


SKILL.MD -- YAML-FRONTMATTER
-----------------------------
各 SKILL.md は YAML-Frontmatter ブロックで始まります。

  ---
  名前: 私のスキル名
  説明: >
    このスキルが提供する能力の簡単な説明。
    最大 1024 文字。
  ライセンス: あり
  互換性:
    - クロードコード
    - コーデックス CLI
  メタデータ:
    著者: ルキッシュ
    バージョン: 1.0.0
    タグ: [自動化、コードレビュー]
  許可されるツール:
    - バッシュ
    - 読む
    - 編集
  ---

必須フィールド:
  名前 最大 64 文字、ケバブ文字 (a ～ z、0 ～ 9、ハイフン)
  説明最大 1024 文字、自由テキスト

オプションのフィールド:
  ライセンス ライセンス識別子 (MIT、Apache 2.0 など)
  互換性 互換性のあるプラットフォームのリスト
  メタデータ 作成者、バージョン、タグなどのフリーキー値。
  allowed-tools スキルが使用を許可されているツールのホワイトリスト

実際のスキル本体は前付の後にマークダウンとして続きます。


プログレッシブ開示 (3 段階)
----------------------------------
標準では 3 段階の読み込みプロセスを使用してトークン バジェットを生成します
効率的に使用するには:

  レベル 1 -- メタデータ (~100 トークン)
    フロントマターのみ (名前、説明、メタデータ)。
    閲覧/検索中にロードされます。 LLM が決定できるようにします
    本文を読まなくてもスキルが適切かどうか。

  レベル 2 -- SKILL.md ボディ (< 5000 トークン)
    SKILL.mdの完全な説明文。
    スキルがアクティブ化/インストールされるときにロードされます。
    すべてのルール、ワークフロー、手順が含まれています。

  レベル 3 -- バンドルされたリソース (オンデマンド)
    References/、script/、およびassets/からのファイル。
    スキルが明示的に要求した場合にのみロードされます
    または、LLM が現在のタスクにそれらを必要とします。

この手順により、初期トークンの消費が低く抑えられ、
必要な場合にのみスケールします。


リファレンス ファイルの名前付け
--------------------------
references/ フォルダー内のファイルは、次の命名規則に従います。

  core-*.md 基本概念と概要
  features-*.md 機能ドキュメントと API リファレンス
  best-practice-*.md 推奨されるプラクティス
  Advanced-*.md 高度なトピックと最適化

例:
  参考資料/core-overview.md
  参照/機能-クエリ-api.md
  参照/ベストプラクティス-エラー処理.md
  references/advanced-performance-tuning.md

この規則により、LLM は適切なものを具体的に検索できるようになります
詳細の検索。


BACH サポート
--------------------
BACH は、Anthropic と互換性のあるスキルを直接スキャフォールディングできます:

  bach skills create <name> --format anthropic

このコマンドは内部で skill_init.py を使用し、以下を作成します。
- 正しい前付を含むSKILL.md
- スクリプト/フォルダー (空)
- 参照/フォルダー (空)
- 資産/フォルダー (空)

既存の BACH スキルをエクスポートできます:

  bach skills export <name> --format anthropic

エクスポートにより、BACH 内部ヘッダーが次のように変換されます。
Anthropic 互換の前付とファイルの再編成。


比較: BACH-INTERNAL VS ANTHROPIC-COMPATIBLE
------------------------------------------------

BACH 人間基準の内部の側面
  ----------------- ------ -----------------------------
  メインファイル SKILL.md SKILL.md
  ヘッダー YAML (拡張) YAML (フロントマター)
  名前欄名(フリー) 名前(ケバブケース、64Z)
  Type フィールドのタイプ (必須) -- (使用不可)
  バージョン version (必須) metadata.version (オプション)
  依存関係 依存関係 (必須) -- (形式化されていない)
  ツール スキルフォルダー内の scripts/
  スキルフォルダー内のドキュメント参照/
  静的ファイル データ/ または アセット/ アセット/
  ワークフロー _workflows/ またはローカルの SKILL.md 本文
  DB同期 あり（スキルテーブル） なし
  Bach スキルのエクスポート ネイティブ形式のエクスポート

BACH 内部スキルにはより多くのメタデータ (タイプ、依存関係、
trigger_phrases)、エクスポート中にメタデータ フィールドに転送されます。
になる。人間と互換性のあるスキルはよりスリムですが、数は少なくなります



スキル VS.エージェント (アントロピック)
------------------------------
アントロピック エコシステムでは、スキルとエージェントは 2 つの別個の概念です。

  スキル: オープンスタンダード (agentskills.io)、ポータブル
          定義場所: .claude/skills/<名前>/SKILL.md
          目的: 指示、知識、ワークフロー

  エージェント: Proprietaer (クロード コード / エージェント SDK のみ)
          定義場所: .claude/agents/<name>.md
          目的: 分離された実行、独自のコンテキスト ウィンドウ

エージェントはスキル フォルダーに定義されません。でも、できます
一緒に働きましょう:

  - スキルはエージェントをトリガーできます: コンテキスト: フォーク + エージェント: <名前>
  - エージェントはスキルをプリロードできます: スキル: [my-skill]

スキルのエクスポートのみが LobeHub/マーケットプレイス (オープン、
ポータブル）。クロード コード エージェントはオプションであり、移植可能ではありません。

BACH エージェントをエクスポートする場合:
  - サブエージェント定義 -> 参照/
  - オーケストレーション コード -> スクリプト/
  - オプション: クロード コード ユーザーの場合は .claude/agents/<name>.md


関連項目
----------
  bach help skills              BACH スキル システム (アーキテクチャ v2.0)
  bach help skill_export        既存のスキルのエクスポート
  bach help naming              命名規則
  bach wiki lobehub             LobeHub マーケットプレイス
  docs/help/skills.txt スキルに関する詳細なドキュメント
  wiki/skills_board.txt スキルボード GUI
