概要
Agent Skills は、手続き的知識とコンテキストをポータブルなフォルダーにパッケージ化し、エージェントが必要に応じて読み込めるようにするオープン標準です。メタデータと指示を含むシンプルな SKILL.md 形式を定義しており、互換性のある AI エージェント間でドメインの専門知識と再現可能なワークフローを実現します。
README プレビュー
# Agent Skills\n\n[](https://discord.gg/MKPE9g8aUy)\n\nA standardized way to give AI agents new capabilities and expertise.\n\n## What are Agent Skills?\n\nAgent Skills are a lightweight, open format for extending AI agent capabilities with specialized knowledge and workflows.\n\nAt its core, a skill is a folder containing a `SKILL.md` file. This file includes metadata (`name` and `description`, at minimum) and instructions that tell an agent how to perform a specific task. Skills can also bundle scripts, reference materials, templates, and other resources.\n\n```\nmy-skill/\n├── SKILL.md # Required: metadata + instructions\n├── scripts/ # Optional: executable code\n├── references/ # Optional: documentation\n├── assets/ # Optional: templates, resources\n└── ... # Any additional files or directories\n```\n\n## Why Agent Skills?\n\nAgents are increasingly capable, but often don't have the context they need to do real work reliably. Skills solve this by packaging procedural knowledge and company-, team-, and user-specific context into portable, version-controlled folders that agents load on demand. This gives agents:\n\n- **Domain expertise**: Capture specialized knowledge — from legal review processes to data analysis pipelines to presentation formatting — as reusable instructions and resources.\n- **Repeatable workflows**: Turn multi-step tasks into consistent, auditable procedures.\n- **Cross-product reuse**: Build a skill once and use it across any skills-compatible agent.\n\n## How do Agent Skills work?\n\nAgents load skills through **progressive disclosure**, in three stages:\n\n1. **Discovery**: At startup, agents load only the name and description of each available skill, just enough to know when it might be relevant.\n\n2. **Activation**: When a task matches a skill's description, the agent reads the full `SKILL.md` instructions into context.\n\n3. **Execution**: The agent follows the instructions, optionally exe
FAQ (1)
トラブル対応なぜ SKILL.md は、ネストされたメタデータを使用すると "cannot unmarshal !!map into string" で失敗するのですか？
トラブル対応
なぜ SKILL.md は、ネストされたメタデータを使用すると "cannot unmarshal !!map into string" で失敗するのですか？SKILL.md のフロントマターにおける metadata フィールドは、文字列から文字列へのマッピングとして定義されています。ネストされたオブジェクト、配列、数値、ブール値には移植性がなく、厳格なクライアントではそれらが拒否されます。メタデータは文字列のキーと文字列の値に平坦化してください。例:
metadata:
hermes_tags: "ADHD, Output Style, Productivity, Formatting"
hermes_category: "productivity"
hermes_related_skills: ""配列やオブジェクトが必要な場合は、文字列(カンマ区切りテキストや JSON など)にシリアライズし、クライアント側でその値をパースさせてください。仕様の概要は、詳細なフィールド定義と一致するように更新されました。キーと値はどちらも文字列でなければなりません。