mirror of
https://github.com/agentskills/agentskills.git
synced 2026-06-18 15:54:06 +08:00
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>
55 lines
1021 B
JSON
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"
|
|
}
|
|
]
|
|
}
|