mirror of
https://github.com/agentskills/agentskills.git
synced 2026-06-18 15:54:06 +08:00
07278fe14a
* Add comprehensive "Integrating skills" guide for client implementors Replace the existing `integrate-skills.mdx` page with a thorough, research-backed guide at `client-implementation/integrating-skills.mdx`. The guide covers the full Agent Skills integration lifecycle in five steps: discover, parse, disclose, activate, and manage context. It was developed from analysis of seven real-world implementations (OpenCode, Pi, Gemini CLI, Codex, VS Code Copilot Chat, Goose, OpenHands) and addresses the practical design decisions developers face: progressive disclosure architecture, cross-client `.agents/skills/` interoperability, lenient YAML parsing for compatibility, catalog XML format, behavioral instruction templates (derived from Pi's production prompts), file-read vs. dedicated tool activation, structured wrapping for context compaction, and permission allowlisting for bundled resources. The guide is architecture-neutral — it covers local filesystem agents, cloud-hosted/sandboxed agents, and agents with or without file-read capabilities, framing these as independent design choices rather than rigid categories. Also adds a redirect from the old `/integrate-skills` URL and updates all internal links (`docs.json`, `home.mdx`, `what-are-skills.mdx`). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * Address PR review feedback on integrating skills guide - Clarify that the XML catalog format is just one option — JSON or bulleted lists work equally well - Qualify "works with any model" to note it requires a file-reading tool Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * Rename "Integrating skills" guide to "Adding skills support" Addresses reviewer feedback that "Integrating" could be misread as integrating skills into a workflow rather than into a client. Renames `integrating-skills.mdx` to `adding-skills-support.mdx` and updates all references in `docs.json`, `home.mdx`, and `what-are-skills.mdx`. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Agent Skills
Agent Skills are a simple, open format for giving agents new capabilities and expertise.
Skills are folders of instructions, scripts, and resources that agents can discover and use to perform better at specific tasks. Write once, use everywhere.
Getting Started
- Documentation - Guides and tutorials
- Specification - Format details
- Example Skills - See what's possible
This repo contains the specification, documentation, and reference SDK. Also see a list of example skills here.
About
Agent Skills is an open format maintained by Anthropic and open to contributions from the community.
License
Code in this repository is licensed under Apache 2.0. Documentation is licensed under CC-BY-4.0. See individual directories for details.