mirror of https://github.com/agentskills/agentskills.git synced 2026-06-18 15:54:06 +08:00

T

Jonathan Hefner 4b9501659b 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>

4b9501659b · 2026-03-02 09:37:34 -06:00

44 Commits

.claude

Add documentation

2025-12-18 08:46:08 -05:00

docs

Add comprehensive "Integrating skills" guide for client implementors

2026-03-02 09:37:34 -06:00

skills-ref

Use GitHub > [!IMPORTANT] callout in skills-ref/README.md (#164 )

2026-02-15 14:41:31 -06:00

.gitignore

Add package.json to docs for local mint dev dependency (#141 )

2026-02-27 17:47:34 -06:00

CONTRIBUTING.md

Add CONTRIBUTING.md (#168 )

2026-02-16 13:24:53 -06:00

LICENSE

Fill in copyright holder in LICENSE appendix (#163 )

2026-02-17 10:05:19 -06:00

package.json

Add package.json to docs for local mint dev dependency (#141 )

2026-02-27 17:47:34 -06:00

README.md

Add top-level Apache 2.0 LICENSE and license section to README (#122 )

2026-02-05 09:18:04 -08:00

README.md

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.