Files
agentskills/docs/docs.json
T
Jonathan HefnerandClaude Opus 4.6 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>
2026-03-02 09:37:34 -06:00

55 lines
1021 B
JSON

{
"$schema": "https://mintlify.com/docs.json",
"theme": "mint",
"name": "Agent Skills",
"colors": {
"primary": "#7f7f7f",
"light": "#bfbfbf",
"dark": "#404040"
},
"favicon": "/favicon.svg",
"navbar": {
"primary": {
"type": "github",
"href": "https://github.com/agentskills/agentskills"
}
},
"navigation": {
"pages": [
"home",
"what-are-skills",
"specification",
{
"group": "For skill creators",
"pages": [
"skill-creation/using-scripts"
]
},
{
"group": "For client implementors",
"pages": [
"client-implementation/integrating-skills"
]
}
]
},
"contextual": {
"options": [
"copy",
"view",
"chatgpt",
"claude",
"perplexity",
"mcp",
"cursor",
"vscode"
]
},
"redirects": [
{
"source": "/integrate-skills",
"destination": "/client-implementation/integrating-skills"
}
]
}