[{"data":1,"prerenderedAt":1201},["ShallowReactive",2],{"navigation_docs_en":3,"-en-ai-skills":128,"-en-ai-skills-surround":1196},[4,41,77,103],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":40},"Getting Started","i-lucide-rocket","\u002Fen\u002Fgetting-started","en\u002F1.getting-started",[10,15,20,25,30,35],{"title":11,"path":12,"stem":13,"icon":14},"Introduction","\u002Fen\u002Fgetting-started\u002Fintroduction","en\u002F1.getting-started\u002F2.introduction","i-lucide-house",{"title":16,"path":17,"stem":18,"icon":19},"Installation","\u002Fen\u002Fgetting-started\u002Finstallation","en\u002F1.getting-started\u002F3.installation","i-lucide-download",{"title":21,"path":22,"stem":23,"icon":24},"Project Structure","\u002Fen\u002Fgetting-started\u002Fproject-structure","en\u002F1.getting-started\u002F4.project-structure","i-lucide-folder-tree",{"title":26,"path":27,"stem":28,"icon":29},"Studio module","\u002Fen\u002Fgetting-started\u002Fstudio","en\u002F1.getting-started\u002F5.studio","i-lucide-mouse-pointer-2",{"title":31,"path":32,"stem":33,"icon":34},"Migration","\u002Fen\u002Fgetting-started\u002Fmigration","en\u002F1.getting-started\u002F6.migration","i-lucide-replace",{"title":36,"path":37,"stem":38,"icon":39},"Troubleshooting","\u002Fen\u002Fgetting-started\u002Ftroubleshooting","en\u002F1.getting-started\u002F7.troubleshooting","i-lucide-wrench",false,{"title":42,"icon":43,"path":44,"stem":45,"children":46,"page":40},"Core Concepts","i-lucide-brain","\u002Fen\u002Fconcepts","en\u002F2.concepts",[47,52,57,62,67,72],{"title":48,"path":49,"stem":50,"icon":51},"Edition","\u002Fen\u002Fconcepts\u002Fedition","en\u002F2.concepts\u002F2.edition","i-lucide-pencil",{"title":53,"path":54,"stem":55,"icon":56},"Configuration","\u002Fen\u002Fconcepts\u002Fconfiguration","en\u002F2.concepts\u002F3.configuration","i-lucide-settings",{"title":58,"path":59,"stem":60,"icon":61},"Theme","\u002Fen\u002Fconcepts\u002Ftheme","en\u002F2.concepts\u002F4.theme","i-lucide-paint-roller",{"title":63,"path":64,"stem":65,"icon":66},"Customization","\u002Fen\u002Fconcepts\u002Fcustomization","en\u002F2.concepts\u002F5.customization","i-lucide-pen-tool",{"title":68,"path":69,"stem":70,"icon":71},"Internationalization","\u002Fen\u002Fconcepts\u002Finternationalization","en\u002F2.concepts\u002F6.internationalization","i-lucide-globe",{"title":73,"path":74,"stem":75,"icon":76},"Nuxt","\u002Fen\u002Fconcepts\u002Fnuxt","en\u002F2.concepts\u002F8.nuxt","i-simple-icons-nuxt",{"title":78,"icon":79,"path":80,"stem":81,"children":82,"page":40},"Essentials","i-lucide-book-open","\u002Fen\u002Fessentials","en\u002F3.essentials",[83,88,93,98],{"title":84,"path":85,"stem":86,"icon":87},"Markdown Syntax","\u002Fen\u002Fessentials\u002Fmarkdown-syntax","en\u002F3.essentials\u002F1.markdown-syntax","i-lucide-heading-1",{"title":89,"path":90,"stem":91,"icon":92},"Code Blocks","\u002Fen\u002Fessentials\u002Fcode-blocks","en\u002F3.essentials\u002F2.code-blocks","i-lucide-code-xml",{"title":94,"path":95,"stem":96,"icon":97},"Components","\u002Fen\u002Fessentials\u002Fcomponents","en\u002F3.essentials\u002F3.components","i-lucide-component",{"title":99,"path":100,"stem":101,"icon":102},"Images and Embeds","\u002Fen\u002Fessentials\u002Fimages-embeds","en\u002F3.essentials\u002F4.images-embeds","i-lucide-image",{"title":104,"icon":105,"path":106,"stem":107,"children":108,"page":40},"AI","i-lucide-sparkles","\u002Fen\u002Fai","en\u002F4.ai",[109,113,118,123],{"title":110,"path":111,"stem":112,"icon":105},"Assistant","\u002Fen\u002Fai\u002Fassistant","en\u002F4.ai\u002F1.assistant",{"title":114,"path":115,"stem":116,"icon":117},"MCP Server","\u002Fen\u002Fai\u002Fmcp","en\u002F4.ai\u002F2.mcp","i-lucide-cpu",{"title":119,"path":120,"stem":121,"icon":122},"Agent Skills","\u002Fen\u002Fai\u002Fskills","en\u002F4.ai\u002F3.skills","i-lucide-wand-sparkles",{"title":124,"path":125,"stem":126,"icon":127},"LLMs Integration","\u002Fen\u002Fai\u002Fllms","en\u002F4.ai\u002F4.llms","i-lucide-message-circle-code",{"id":129,"title":119,"body":130,"description":1190,"extension":268,"links":1191,"meta":1192,"navigation":1193,"path":120,"seo":1194,"stem":121,"__hash__":1195},"docs_en\u002Fen\u002F4.ai\u002F3.skills.md",{"type":131,"value":132,"toc":1171},"minimark",[133,138,159,170,175,179,405,409,414,509,520,531,534,547,626,630,638,674,677,681,684,756,763,767,770,779,795,809,812,816,837,843,847,855,858,1025,1029,1035,1065,1069,1076,1161,1167],[134,135,137],"h2",{"id":136},"about-agent-skills","About Agent Skills",[139,140,141,142,146,147,150,151,158],"p",{},"Docus automatically discovers skills in your ",[143,144,145],"code",{},"skills\u002F"," directory and serves them at ",[143,148,149],{},"\u002F.well-known\u002Fagent-skills\u002F",", following the ",[152,153,157],"a",{"href":154,"rel":155},"https:\u002F\u002Fgithub.com\u002Fcloudflare\u002Fagent-skills-discovery-rfc",[156],"nofollow","Cloudflare Agent Skills Discovery RFC",". This makes your skills installable from any documentation URL with a single command.",[139,160,161,165,166,169],{},[152,162,119],{"href":163,"rel":164},"https:\u002F\u002Fagentskills.io\u002F",[156]," are a lightweight, open format for giving AI agents specialized knowledge and workflows. A skill is a ",[143,167,168],{},"SKILL.md"," file with YAML frontmatter that describes what agents can do with your product, along with optional supporting reference files.",[171,172,174],"note",{"to":173},"https:\u002F\u002Fdocus.dev\u002F.well-known\u002Fagent-skills\u002Findex.json","See the skills published on this documentation site.",[134,176,178],{"id":177},"quick-start","Quick Start",[180,181,182,187,196,242,246,263,366,370,376,380,383,402],"steps",{},[183,184,186],"h3",{"id":185},"create-a-skill","Create a skill",[139,188,189,190,192,193,195],{},"Add a ",[143,191,145],{}," directory at the root of your Docus project with a skill subdirectory containing a ",[143,194,168],{}," file:",[197,198,203],"pre",{"className":199,"code":200,"language":201,"meta":202,"style":202},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","my-docs\u002F\n└── skills\u002F\n    └── my-product\u002F\n        └── SKILL.md\n","bash","",[143,204,205,214,224,233],{"__ignoreMap":202},[206,207,210],"span",{"class":208,"line":209},"line",1,[206,211,213],{"class":212},"sBMFI","my-docs\u002F\n",[206,215,217,220],{"class":208,"line":216},2,[206,218,219],{"class":212},"└──",[206,221,223],{"class":222},"sfazB"," skills\u002F\n",[206,225,227,230],{"class":208,"line":226},3,[206,228,229],{"class":212},"    └──",[206,231,232],{"class":222}," my-product\u002F\n",[206,234,236,239],{"class":208,"line":235},4,[206,237,238],{"class":212},"        └──",[206,240,241],{"class":222}," SKILL.md\n",[183,243,245],{"id":244},"write-your-skillmd","Write your SKILL.md",[139,247,248,249,254,255,258,259,262],{},"Follow the ",[152,250,253],{"href":251,"rel":252},"https:\u002F\u002Fagentskills.io\u002Fspecification",[156],"agentskills.io specification",". The only required frontmatter field is ",[143,256,257],{},"description"," — ",[143,260,261],{},"name"," defaults to the directory name if omitted:",[197,264,269],{"className":265,"code":266,"filename":267,"language":268,"meta":202,"style":202},"language-md shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","---\nname: my-product\ndescription: Build and deploy apps with My Product. Use when creating projects, configuring settings, or troubleshooting issues.\n---\n\n# My Product\n\n## Getting Started\n\nCreate a new project:\n\n\\`\\`\\`bash\nnpx create-my-product my-app\n\\`\\`\\`\n","skills\u002Fmy-product\u002FSKILL.md","md",[143,270,271,277,288,297,301,308,317,322,331,336,343,348,354,360],{"__ignoreMap":202},[206,272,273],{"class":208,"line":209},[206,274,276],{"class":275},"sMK4o","---\n",[206,278,279,282,285],{"class":208,"line":216},[206,280,261],{"class":281},"swJcz",[206,283,284],{"class":275},":",[206,286,287],{"class":222}," my-product\n",[206,289,290,292,294],{"class":208,"line":226},[206,291,257],{"class":281},[206,293,284],{"class":275},[206,295,296],{"class":222}," Build and deploy apps with My Product. Use when creating projects, configuring settings, or troubleshooting issues.\n",[206,298,299],{"class":208,"line":235},[206,300,276],{"class":275},[206,302,304],{"class":208,"line":303},5,[206,305,307],{"emptyLinePlaceholder":306},true,"\n",[206,309,311,314],{"class":208,"line":310},6,[206,312,313],{"class":275},"# ",[206,315,316],{"class":212},"My Product\n",[206,318,320],{"class":208,"line":319},7,[206,321,307],{"emptyLinePlaceholder":306},[206,323,325,328],{"class":208,"line":324},8,[206,326,327],{"class":275},"## ",[206,329,330],{"class":212},"Getting Started\n",[206,332,334],{"class":208,"line":333},9,[206,335,307],{"emptyLinePlaceholder":306},[206,337,339],{"class":208,"line":338},10,[206,340,342],{"class":341},"sTEyZ","Create a new project:\n",[206,344,346],{"class":208,"line":345},11,[206,347,307],{"emptyLinePlaceholder":306},[206,349,351],{"class":208,"line":350},12,[206,352,353],{"class":341},"\\`\\`\\`bash\n",[206,355,357],{"class":208,"line":356},13,[206,358,359],{"class":341},"npx create-my-product my-app\n",[206,361,363],{"class":208,"line":362},14,[206,364,365],{"class":341},"\\`\\`\\`\n",[183,367,369],{"id":368},"deploy","Deploy",[139,371,372,373,375],{},"Deploy your documentation. Docus automatically serves your skills at ",[143,374,149],{},".",[183,377,379],{"id":378},"share-with-users","Share with users",[139,381,382],{},"Users can install your skills with a single command:",[197,384,386],{"className":199,"code":385,"language":201,"meta":202,"style":202},"npx skills add https:\u002F\u002Fyour-docs-domain.com\n",[143,387,388],{"__ignoreMap":202},[206,389,390,393,396,399],{"class":208,"line":209},[206,391,392],{"class":212},"npx",[206,394,395],{"class":222}," skills",[206,397,398],{"class":222}," add",[206,400,401],{"class":222}," https:\u002F\u002Fyour-docs-domain.com\n",[139,403,404],{},"The CLI detects installed agents (Claude Code, Cursor, Windsurf, and others) and installs the skill to all of them.",[134,406,408],{"id":407},"directory-structure","Directory Structure",[139,410,411,412,284],{},"A skill directory can contain supporting files beyond ",[143,413,168],{},[197,415,417],{"className":199,"code":416,"language":201,"meta":202,"style":202},"skills\u002F\n└── my-product\u002F\n    ├── SKILL.md              # Required: instructions + metadata\n    ├── references\u002F           # Optional: additional documentation\n    │   ├── api.md\n    │   └── configuration.md\n    ├── scripts\u002F              # Optional: executable code\n    │   └── setup.sh\n    └── assets\u002F               # Optional: templates, schemas\n        └── config.template.yaml\n",[143,418,419,424,430,442,452,463,473,483,492,502],{"__ignoreMap":202},[206,420,421],{"class":208,"line":209},[206,422,423],{"class":212},"skills\u002F\n",[206,425,426,428],{"class":208,"line":216},[206,427,219],{"class":212},[206,429,232],{"class":222},[206,431,432,435,438],{"class":208,"line":226},[206,433,434],{"class":212},"    ├──",[206,436,437],{"class":222}," SKILL.md",[206,439,441],{"class":440},"sHwdD","              # Required: instructions + metadata\n",[206,443,444,446,449],{"class":208,"line":235},[206,445,434],{"class":212},[206,447,448],{"class":222}," references\u002F",[206,450,451],{"class":440},"           # Optional: additional documentation\n",[206,453,454,457,460],{"class":208,"line":303},[206,455,456],{"class":212},"    │",[206,458,459],{"class":222},"   ├──",[206,461,462],{"class":222}," api.md\n",[206,464,465,467,470],{"class":208,"line":310},[206,466,456],{"class":212},[206,468,469],{"class":222},"   └──",[206,471,472],{"class":222}," configuration.md\n",[206,474,475,477,480],{"class":208,"line":319},[206,476,434],{"class":212},[206,478,479],{"class":222}," scripts\u002F",[206,481,482],{"class":440},"              # Optional: executable code\n",[206,484,485,487,489],{"class":208,"line":324},[206,486,456],{"class":212},[206,488,469],{"class":222},[206,490,491],{"class":222}," setup.sh\n",[206,493,494,496,499],{"class":208,"line":333},[206,495,229],{"class":212},[206,497,498],{"class":222}," assets\u002F",[206,500,501],{"class":440},"               # Optional: templates, schemas\n",[206,503,504,506],{"class":208,"line":338},[206,505,238],{"class":212},[206,507,508],{"class":222}," config.template.yaml\n",[139,510,511,512,515,516,519],{},"Single-file skills are served as ",[143,513,514],{},"skill-md"," artifacts. Skills with supporting files are bundled as ",[143,517,518],{},".tar.gz"," archives so agents can download the complete skill directory in one verified artifact.",[521,522,523,524,526,527,530],"tip",{},"Keep your main ",[143,525,168],{}," under 500 lines. Move detailed reference material to separate files in ",[143,528,529],{},"references\u002F"," — agents load these on demand, so smaller files mean less context usage.",[134,532,53],{"id":533},"configuration",[139,535,536,537,539,540,543,544,284],{},"By default, Docus looks for skills in the ",[143,538,145],{}," directory at the root of your project. You can change this with ",[143,541,542],{},"docus.skills.dir"," in your ",[143,545,546],{},"nuxt.config.ts",[197,548,552],{"className":549,"code":550,"filename":546,"language":551,"meta":202,"style":202},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","export default defineNuxtConfig({\n  docus: {\n    skills: {\n      dir: 'agent-skills'\n    }\n  }\n})\n","ts",[143,553,554,573,583,592,608,613,618],{"__ignoreMap":202},[206,555,556,560,563,567,570],{"class":208,"line":209},[206,557,559],{"class":558},"s7zQu","export",[206,561,562],{"class":558}," default",[206,564,566],{"class":565},"s2Zo4"," defineNuxtConfig",[206,568,569],{"class":341},"(",[206,571,572],{"class":275},"{\n",[206,574,575,578,580],{"class":208,"line":216},[206,576,577],{"class":281},"  docus",[206,579,284],{"class":275},[206,581,582],{"class":275}," {\n",[206,584,585,588,590],{"class":208,"line":226},[206,586,587],{"class":281},"    skills",[206,589,284],{"class":275},[206,591,582],{"class":275},[206,593,594,597,599,602,605],{"class":208,"line":235},[206,595,596],{"class":281},"      dir",[206,598,284],{"class":275},[206,600,601],{"class":275}," '",[206,603,604],{"class":222},"agent-skills",[206,606,607],{"class":275},"'\n",[206,609,610],{"class":208,"line":303},[206,611,612],{"class":275},"    }\n",[206,614,615],{"class":208,"line":310},[206,616,617],{"class":275},"  }\n",[206,619,620,623],{"class":208,"line":319},[206,621,622],{"class":275},"}",[206,624,625],{"class":341},")\n",[134,627,629],{"id":628},"skill-name-requirements","Skill Name Requirements",[139,631,632,633,284],{},"Skill names must follow the ",[152,634,637],{"href":635,"rel":636},"https:\u002F\u002Fagentskills.io\u002Fspecification#name-field",[156],"Agent Skills naming specification",[639,640,641,645,659,662,668],"ul",{},[642,643,644],"li",{},"1-64 characters",[642,646,647,648,651,652,651,655,658],{},"Lowercase letters, numbers, and hyphens only (",[143,649,650],{},"a-z",", ",[143,653,654],{},"0-9",[143,656,657],{},"-",")",[642,660,661],{},"Must not start or end with a hyphen",[642,663,664,665,658],{},"Must not contain consecutive hyphens (",[143,666,667],{},"--",[642,669,670,671,673],{},"The ",[143,672,261],{}," field in frontmatter must match the parent directory name",[171,675,676],{},"Skills that fail validation are skipped — check your build output for warnings.",[134,678,680],{"id":679},"multiple-skills","Multiple Skills",[139,682,683],{},"You can publish multiple skills from a single documentation site:",[197,685,687],{"className":199,"code":686,"language":201,"meta":202,"style":202},"skills\u002F\n├── my-product\u002F\n│   └── SKILL.md\n├── create-project\u002F\n│   ├── SKILL.md\n│   └── references\u002F\n│       └── templates.md\n└── migration-guide\u002F\n    └── SKILL.md\n",[143,688,689,693,700,709,716,724,733,743,750],{"__ignoreMap":202},[206,690,691],{"class":208,"line":209},[206,692,423],{"class":212},[206,694,695,698],{"class":208,"line":216},[206,696,697],{"class":212},"├──",[206,699,232],{"class":222},[206,701,702,705,707],{"class":208,"line":226},[206,703,704],{"class":212},"│",[206,706,469],{"class":222},[206,708,241],{"class":222},[206,710,711,713],{"class":208,"line":235},[206,712,697],{"class":212},[206,714,715],{"class":222}," create-project\u002F\n",[206,717,718,720,722],{"class":208,"line":303},[206,719,704],{"class":212},[206,721,459],{"class":222},[206,723,241],{"class":222},[206,725,726,728,730],{"class":208,"line":310},[206,727,704],{"class":212},[206,729,469],{"class":222},[206,731,732],{"class":222}," references\u002F\n",[206,734,735,737,740],{"class":208,"line":319},[206,736,704],{"class":212},[206,738,739],{"class":222},"       └──",[206,741,742],{"class":222}," templates.md\n",[206,744,745,747],{"class":208,"line":324},[206,746,219],{"class":212},[206,748,749],{"class":222}," migration-guide\u002F\n",[206,751,752,754],{"class":208,"line":333},[206,753,229],{"class":212},[206,755,241],{"class":222},[139,757,758,759,762],{},"All skills appear in the ",[143,760,761],{},"index.json"," catalog and are independently installable.",[134,764,766],{"id":765},"preview-and-versioning","Preview and Versioning",[139,768,769],{},"Since skills live in your repository alongside your documentation, they benefit from your existing Git workflow:",[639,771,772],{},[642,773,774,778],{},[775,776,777],"strong",{},"Branch previews",": Test skill changes on preview deployments before merging. On Vercel, every pull request gets a preview URL where you can verify your skills work correctly:",[197,780,782],{"className":199,"code":781,"language":201,"meta":202,"style":202},"npx skills add https:\u002F\u002Fmy-docs-git-feat-new-skill.vercel.app\n",[143,783,784],{"__ignoreMap":202},[206,785,786,788,790,792],{"class":208,"line":209},[206,787,392],{"class":212},[206,789,395],{"class":222},[206,791,398],{"class":222},[206,793,794],{"class":222}," https:\u002F\u002Fmy-docs-git-feat-new-skill.vercel.app\n",[639,796,797,803],{},[642,798,799,802],{},[775,800,801],{},"Version control",": Track skill changes with Git history, review diffs in pull requests, and roll back if needed.",[642,804,805,808],{},[775,806,807],{},"CI\u002FCD",": Skills are built and deployed automatically with your documentation — no separate publishing step.",[521,810,811],{},"Use preview URLs to test skills with your AI tools before shipping to production. This ensures your skill instructions work correctly with real agents.",[134,813,815],{"id":814},"how-discovery-works","How Discovery Works",[139,817,818,819,822,823,828,829,832,833,836],{},"This feature implements the ",[152,820,157],{"href":154,"rel":821},[156],", which extends ",[152,824,827],{"href":825,"rel":826},"https:\u002F\u002Fdatatracker.ietf.org\u002Fdoc\u002Fhtml\u002Frfc8615",[156],"RFC 8615"," (the same ",[143,830,831],{},".well-known"," standard behind ACME certificate validation and ",[143,834,835],{},"security.txt",").",[139,838,839,840,842],{},"Docus scans your ",[143,841,145],{}," directory at build time and generates two types of endpoints:",[183,844,846],{"id":845},"discovery-index","Discovery index",[197,848,853],{"className":849,"code":851,"language":852},[850],"language-text","GET \u002F.well-known\u002Fagent-skills\u002Findex.json\n","text",[143,854,851],{"__ignoreMap":202},[139,856,857],{},"Returns a JSON catalog listing all available skills with their descriptions, artifact URLs, and SHA-256 digests:",[197,859,863],{"className":860,"code":861,"language":862,"meta":202,"style":202},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"$schema\": \"https:\u002F\u002Fschemas.agentskills.io\u002Fdiscovery\u002F0.2.0\u002Fschema.json\",\n  \"skills\": [\n    {\n      \"name\": \"my-product\",\n      \"type\": \"archive\",\n      \"description\": \"Build and deploy apps with My Product.\",\n      \"url\": \"\u002F.well-known\u002Fagent-skills\u002Fmy-product.tar.gz\",\n      \"digest\": \"sha256:c4d5e6f7...\"\n    }\n  ]\n}\n","json",[143,864,865,869,894,908,913,933,953,972,992,1011,1015,1020],{"__ignoreMap":202},[206,866,867],{"class":208,"line":209},[206,868,572],{"class":275},[206,870,871,874,878,881,883,886,889,891],{"class":208,"line":216},[206,872,873],{"class":275},"  \"",[206,875,877],{"class":876},"spNyl","$schema",[206,879,880],{"class":275},"\"",[206,882,284],{"class":275},[206,884,885],{"class":275}," \"",[206,887,888],{"class":222},"https:\u002F\u002Fschemas.agentskills.io\u002Fdiscovery\u002F0.2.0\u002Fschema.json",[206,890,880],{"class":275},[206,892,893],{"class":275},",\n",[206,895,896,898,901,903,905],{"class":208,"line":226},[206,897,873],{"class":275},[206,899,900],{"class":876},"skills",[206,902,880],{"class":275},[206,904,284],{"class":275},[206,906,907],{"class":275}," [\n",[206,909,910],{"class":208,"line":235},[206,911,912],{"class":275},"    {\n",[206,914,915,918,920,922,924,926,929,931],{"class":208,"line":303},[206,916,917],{"class":275},"      \"",[206,919,261],{"class":212},[206,921,880],{"class":275},[206,923,284],{"class":275},[206,925,885],{"class":275},[206,927,928],{"class":222},"my-product",[206,930,880],{"class":275},[206,932,893],{"class":275},[206,934,935,937,940,942,944,946,949,951],{"class":208,"line":310},[206,936,917],{"class":275},[206,938,939],{"class":212},"type",[206,941,880],{"class":275},[206,943,284],{"class":275},[206,945,885],{"class":275},[206,947,948],{"class":222},"archive",[206,950,880],{"class":275},[206,952,893],{"class":275},[206,954,955,957,959,961,963,965,968,970],{"class":208,"line":319},[206,956,917],{"class":275},[206,958,257],{"class":212},[206,960,880],{"class":275},[206,962,284],{"class":275},[206,964,885],{"class":275},[206,966,967],{"class":222},"Build and deploy apps with My Product.",[206,969,880],{"class":275},[206,971,893],{"class":275},[206,973,974,976,979,981,983,985,988,990],{"class":208,"line":324},[206,975,917],{"class":275},[206,977,978],{"class":212},"url",[206,980,880],{"class":275},[206,982,284],{"class":275},[206,984,885],{"class":275},[206,986,987],{"class":222},"\u002F.well-known\u002Fagent-skills\u002Fmy-product.tar.gz",[206,989,880],{"class":275},[206,991,893],{"class":275},[206,993,994,996,999,1001,1003,1005,1008],{"class":208,"line":333},[206,995,917],{"class":275},[206,997,998],{"class":212},"digest",[206,1000,880],{"class":275},[206,1002,284],{"class":275},[206,1004,885],{"class":275},[206,1006,1007],{"class":222},"sha256:c4d5e6f7...",[206,1009,1010],{"class":275},"\"\n",[206,1012,1013],{"class":208,"line":338},[206,1014,612],{"class":275},[206,1016,1017],{"class":208,"line":345},[206,1018,1019],{"class":275},"  ]\n",[206,1021,1022],{"class":208,"line":350},[206,1023,1024],{"class":275},"}\n",[183,1026,1028],{"id":1027},"skill-artifacts","Skill artifacts",[197,1030,1033],{"className":1031,"code":1032,"language":852},[850],"GET \u002F.well-known\u002Fagent-skills\u002F{skill-name}\u002FSKILL.md\nGET \u002F.well-known\u002Fagent-skills\u002F{skill-name}.tar.gz\n",[143,1034,1032],{"__ignoreMap":202},[139,1036,1037,1038,1040,1041,1044,1045,1048,1049,651,1051,651,1054,1057,1058,1061,1062,375],{},"Skills that only contain ",[143,1039,168],{}," are served directly with ",[143,1042,1043],{},"type: \"skill-md\""," and ",[143,1046,1047],{},"text\u002Fmarkdown",". Skills with ",[143,1050,529],{},[143,1052,1053],{},"scripts\u002F",[143,1055,1056],{},"assets\u002F",", or other support files are served as ",[143,1059,1060],{},"type: \"archive\""," with ",[143,1063,1064],{},"application\u002Fgzip",[134,1066,1068],{"id":1067},"comparison-with-llmstxt","Comparison with llms.txt",[139,1070,1071,1072,1075],{},"Both ",[143,1073,1074],{},"llms.txt"," and Agent Skills help AI tools work with your documentation, but they serve different purposes:",[1077,1078,1079,1092],"table",{},[1080,1081,1082],"thead",{},[1083,1084,1085,1088,1090],"tr",{},[1086,1087],"th",{},[1086,1089,1074],{},[1086,1091,119],{},[1093,1094,1095,1109,1122,1135,1148],"tbody",{},[1083,1096,1097,1103,1106],{},[1098,1099,1100],"td",{},[775,1101,1102],{},"Purpose",[1098,1104,1105],{},"Directory of all documentation pages",[1098,1107,1108],{},"Capability summary with actionable instructions",[1083,1110,1111,1116,1119],{},[1098,1112,1113],{},[775,1114,1115],{},"Content",[1098,1117,1118],{},"Page titles, descriptions, and links",[1098,1120,1121],{},"Step-by-step workflows, code examples, constraints",[1083,1123,1124,1129,1132],{},[1098,1125,1126],{},[775,1127,1128],{},"Loaded",[1098,1130,1131],{},"At discovery time",[1098,1133,1134],{},"On demand, when the skill is activated",[1083,1136,1137,1142,1145],{},[1098,1138,1139],{},[775,1140,1141],{},"Format",[1098,1143,1144],{},"Plain text with links",[1098,1146,1147],{},"Markdown with YAML frontmatter",[1083,1149,1150,1155,1158],{},[1098,1151,1152],{},[775,1153,1154],{},"Best for",[1098,1156,1157],{},"Helping agents find information",[1098,1159,1160],{},"Teaching agents how to use your product",[521,1162,1163,1164,1166],{},"Use both together: ",[143,1165,1074],{}," tells agents where to find information, while skills tell agents what they can accomplish and how.",[1168,1169,1170],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}",{"title":202,"searchDepth":216,"depth":216,"links":1172},[1173,1174,1180,1181,1182,1183,1184,1185,1189],{"id":136,"depth":216,"text":137},{"id":177,"depth":216,"text":178,"children":1175},[1176,1177,1178,1179],{"id":185,"depth":226,"text":186},{"id":244,"depth":226,"text":245},{"id":368,"depth":226,"text":369},{"id":378,"depth":226,"text":379},{"id":407,"depth":216,"text":408},{"id":533,"depth":216,"text":53},{"id":628,"depth":216,"text":629},{"id":679,"depth":216,"text":680},{"id":765,"depth":216,"text":766},{"id":814,"depth":216,"text":815,"children":1186},[1187,1188],{"id":845,"depth":226,"text":846},{"id":1027,"depth":226,"text":1028},{"id":1067,"depth":216,"text":1068},"Publish agent skills from your documentation site so AI tools can discover and install them automatically.",null,{},{"icon":122},{"title":119,"description":1190},"KNtM-VkO0QXKEn9Ddp5P2Yj7Hot4ZQHHx9IBTyJyzy8",[1197,1199],{"title":114,"path":115,"stem":116,"description":1198,"icon":117,"children":-1},"Connect your documentation to AI tools with a native MCP server.",{"title":124,"path":125,"stem":126,"description":1200,"icon":127,"children":-1},"Docus generate AI-ready content files using Nuxt LLMs module",1776681149204]