[{"data":1,"prerenderedAt":1141},["ShallowReactive",2],{"navigation_docs_en":3,"-en-ai-skills":128,"-en-ai-skills-surround":1136},[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":1130,"extension":268,"links":1131,"meta":1132,"navigation":1133,"path":120,"seo":1134,"stem":121,"__hash__":1135},"docs_en\u002Fen\u002F4.ai\u002F3.skills.md",{"type":131,"value":132,"toc":1111},"minimark",[133,138,159,170,175,179,405,409,414,509,519,530,533,546,625,629,637,673,676,680,683,755,761,765,768,777,793,807,810,814,835,841,845,853,856,977,981,987,1005,1009,1016,1101,1107],[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\u002Fskills\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\u002Fskills\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,375],{},"All files are automatically listed in the ",[143,513,514],{},"index.json"," catalog and served at their respective paths under ",[143,517,518],{},"\u002F.well-known\u002Fskills\u002F{skill-name}\u002F",[520,521,522,523,525,526,529],"tip",{},"Keep your main ",[143,524,168],{}," under 500 lines. Move detailed reference material to separate files in ",[143,527,528],{},"references\u002F"," — agents load these on demand, so smaller files mean less context usage.",[134,531,53],{"id":532},"configuration",[139,534,535,536,538,539,542,543,284],{},"By default, Docus looks for skills in the ",[143,537,145],{}," directory at the root of your project. You can change this with ",[143,540,541],{},"docus.skills.dir"," in your ",[143,544,545],{},"nuxt.config.ts",[197,547,551],{"className":548,"code":549,"filename":545,"language":550,"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,552,553,572,582,591,607,612,617],{"__ignoreMap":202},[206,554,555,559,562,566,569],{"class":208,"line":209},[206,556,558],{"class":557},"s7zQu","export",[206,560,561],{"class":557}," default",[206,563,565],{"class":564},"s2Zo4"," defineNuxtConfig",[206,567,568],{"class":341},"(",[206,570,571],{"class":275},"{\n",[206,573,574,577,579],{"class":208,"line":216},[206,575,576],{"class":281},"  docus",[206,578,284],{"class":275},[206,580,581],{"class":275}," {\n",[206,583,584,587,589],{"class":208,"line":226},[206,585,586],{"class":281},"    skills",[206,588,284],{"class":275},[206,590,581],{"class":275},[206,592,593,596,598,601,604],{"class":208,"line":235},[206,594,595],{"class":281},"      dir",[206,597,284],{"class":275},[206,599,600],{"class":275}," '",[206,602,603],{"class":222},"agent-skills",[206,605,606],{"class":275},"'\n",[206,608,609],{"class":208,"line":303},[206,610,611],{"class":275},"    }\n",[206,613,614],{"class":208,"line":310},[206,615,616],{"class":275},"  }\n",[206,618,619,622],{"class":208,"line":319},[206,620,621],{"class":275},"}",[206,623,624],{"class":341},")\n",[134,626,628],{"id":627},"skill-name-requirements","Skill Name Requirements",[139,630,631,632,284],{},"Skill names must follow the ",[152,633,636],{"href":634,"rel":635},"https:\u002F\u002Fagentskills.io\u002Fspecification#name-field",[156],"Agent Skills naming specification",[638,639,640,644,658,661,667],"ul",{},[641,642,643],"li",{},"1-64 characters",[641,645,646,647,650,651,650,654,657],{},"Lowercase letters, numbers, and hyphens only (",[143,648,649],{},"a-z",", ",[143,652,653],{},"0-9",[143,655,656],{},"-",")",[641,659,660],{},"Must not start or end with a hyphen",[641,662,663,664,657],{},"Must not contain consecutive hyphens (",[143,665,666],{},"--",[641,668,669,670,672],{},"The ",[143,671,261],{}," field in frontmatter must match the parent directory name",[171,674,675],{},"Skills that fail validation are skipped — check your build output for warnings.",[134,677,679],{"id":678},"multiple-skills","Multiple Skills",[139,681,682],{},"You can publish multiple skills from a single documentation site:",[197,684,686],{"className":199,"code":685,"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,687,688,692,699,708,715,723,732,742,749],{"__ignoreMap":202},[206,689,690],{"class":208,"line":209},[206,691,423],{"class":212},[206,693,694,697],{"class":208,"line":216},[206,695,696],{"class":212},"├──",[206,698,232],{"class":222},[206,700,701,704,706],{"class":208,"line":226},[206,702,703],{"class":212},"│",[206,705,469],{"class":222},[206,707,241],{"class":222},[206,709,710,712],{"class":208,"line":235},[206,711,696],{"class":212},[206,713,714],{"class":222}," create-project\u002F\n",[206,716,717,719,721],{"class":208,"line":303},[206,718,703],{"class":212},[206,720,459],{"class":222},[206,722,241],{"class":222},[206,724,725,727,729],{"class":208,"line":310},[206,726,703],{"class":212},[206,728,469],{"class":222},[206,730,731],{"class":222}," references\u002F\n",[206,733,734,736,739],{"class":208,"line":319},[206,735,703],{"class":212},[206,737,738],{"class":222},"       └──",[206,740,741],{"class":222}," templates.md\n",[206,743,744,746],{"class":208,"line":324},[206,745,219],{"class":212},[206,747,748],{"class":222}," migration-guide\u002F\n",[206,750,751,753],{"class":208,"line":333},[206,752,229],{"class":212},[206,754,241],{"class":222},[139,756,757,758,760],{},"All skills appear in the ",[143,759,514],{}," catalog and are independently installable.",[134,762,764],{"id":763},"preview-and-versioning","Preview and Versioning",[139,766,767],{},"Since skills live in your repository alongside your documentation, they benefit from your existing Git workflow:",[638,769,770],{},[641,771,772,776],{},[773,774,775],"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,778,780],{"className":199,"code":779,"language":201,"meta":202,"style":202},"npx skills add https:\u002F\u002Fmy-docs-git-feat-new-skill.vercel.app\n",[143,781,782],{"__ignoreMap":202},[206,783,784,786,788,790],{"class":208,"line":209},[206,785,392],{"class":212},[206,787,395],{"class":222},[206,789,398],{"class":222},[206,791,792],{"class":222}," https:\u002F\u002Fmy-docs-git-feat-new-skill.vercel.app\n",[638,794,795,801],{},[641,796,797,800],{},[773,798,799],{},"Version control",": Track skill changes with Git history, review diffs in pull requests, and roll back if needed.",[641,802,803,806],{},[773,804,805],{},"CI\u002FCD",": Skills are built and deployed automatically with your documentation — no separate publishing step.",[520,808,809],{},"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,811,813],{"id":812},"how-discovery-works","How Discovery Works",[139,815,816,817,820,821,826,827,830,831,834],{},"This feature implements the ",[152,818,157],{"href":154,"rel":819},[156],", which extends ",[152,822,825],{"href":823,"rel":824},"https:\u002F\u002Fdatatracker.ietf.org\u002Fdoc\u002Fhtml\u002Frfc8615",[156],"RFC 8615"," (the same ",[143,828,829],{},".well-known"," standard behind ACME certificate validation and ",[143,832,833],{},"security.txt",").",[139,836,837,838,840],{},"Docus scans your ",[143,839,145],{}," directory at build time and generates two types of endpoints:",[183,842,844],{"id":843},"discovery-index","Discovery index",[197,846,851],{"className":847,"code":849,"language":850},[848],"language-text","GET \u002F.well-known\u002Fskills\u002Findex.json\n","text",[143,852,849],{"__ignoreMap":202},[139,854,855],{},"Returns a JSON catalog listing all available skills with their descriptions and files:",[197,857,861],{"className":858,"code":859,"language":860,"meta":202,"style":202},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"skills\": [\n    {\n      \"name\": \"my-product\",\n      \"description\": \"Build and deploy apps with My Product.\",\n      \"files\": [\"SKILL.md\", \"references\u002Fapi.md\"]\n    }\n  ]\n}\n","json",[143,862,863,867,884,889,911,930,963,967,972],{"__ignoreMap":202},[206,864,865],{"class":208,"line":209},[206,866,571],{"class":275},[206,868,869,872,876,879,881],{"class":208,"line":216},[206,870,871],{"class":275},"  \"",[206,873,875],{"class":874},"spNyl","skills",[206,877,878],{"class":275},"\"",[206,880,284],{"class":275},[206,882,883],{"class":275}," [\n",[206,885,886],{"class":208,"line":226},[206,887,888],{"class":275},"    {\n",[206,890,891,894,896,898,900,903,906,908],{"class":208,"line":235},[206,892,893],{"class":275},"      \"",[206,895,261],{"class":212},[206,897,878],{"class":275},[206,899,284],{"class":275},[206,901,902],{"class":275}," \"",[206,904,905],{"class":222},"my-product",[206,907,878],{"class":275},[206,909,910],{"class":275},",\n",[206,912,913,915,917,919,921,923,926,928],{"class":208,"line":303},[206,914,893],{"class":275},[206,916,257],{"class":212},[206,918,878],{"class":275},[206,920,284],{"class":275},[206,922,902],{"class":275},[206,924,925],{"class":222},"Build and deploy apps with My Product.",[206,927,878],{"class":275},[206,929,910],{"class":275},[206,931,932,934,937,939,941,944,946,948,950,953,955,958,960],{"class":208,"line":310},[206,933,893],{"class":275},[206,935,936],{"class":212},"files",[206,938,878],{"class":275},[206,940,284],{"class":275},[206,942,943],{"class":275}," [",[206,945,878],{"class":275},[206,947,168],{"class":222},[206,949,878],{"class":275},[206,951,952],{"class":275},",",[206,954,902],{"class":275},[206,956,957],{"class":222},"references\u002Fapi.md",[206,959,878],{"class":275},[206,961,962],{"class":275},"]\n",[206,964,965],{"class":208,"line":319},[206,966,611],{"class":275},[206,968,969],{"class":208,"line":324},[206,970,971],{"class":275},"  ]\n",[206,973,974],{"class":208,"line":333},[206,975,976],{"class":275},"}\n",[183,978,980],{"id":979},"skill-files","Skill files",[197,982,985],{"className":983,"code":984,"language":850},[848],"GET \u002F.well-known\u002Fskills\u002F{skill-name}\u002FSKILL.md\nGET \u002F.well-known\u002Fskills\u002F{skill-name}\u002Freferences\u002Fapi.md\n",[143,986,984],{"__ignoreMap":202},[139,988,989,990,993,994,997,998,993,1001,1004],{},"Individual skill files are served with appropriate content types (",[143,991,992],{},"text\u002Fmarkdown"," for ",[143,995,996],{},".md"," files, ",[143,999,1000],{},"application\u002Fjson",[143,1002,1003],{},".json",", etc.).",[134,1006,1008],{"id":1007},"comparison-with-llmstxt","Comparison with llms.txt",[139,1010,1011,1012,1015],{},"Both ",[143,1013,1014],{},"llms.txt"," and Agent Skills help AI tools work with your documentation, but they serve different purposes:",[1017,1018,1019,1032],"table",{},[1020,1021,1022],"thead",{},[1023,1024,1025,1028,1030],"tr",{},[1026,1027],"th",{},[1026,1029,1014],{},[1026,1031,119],{},[1033,1034,1035,1049,1062,1075,1088],"tbody",{},[1023,1036,1037,1043,1046],{},[1038,1039,1040],"td",{},[773,1041,1042],{},"Purpose",[1038,1044,1045],{},"Directory of all documentation pages",[1038,1047,1048],{},"Capability summary with actionable instructions",[1023,1050,1051,1056,1059],{},[1038,1052,1053],{},[773,1054,1055],{},"Content",[1038,1057,1058],{},"Page titles, descriptions, and links",[1038,1060,1061],{},"Step-by-step workflows, code examples, constraints",[1023,1063,1064,1069,1072],{},[1038,1065,1066],{},[773,1067,1068],{},"Loaded",[1038,1070,1071],{},"At discovery time",[1038,1073,1074],{},"On demand, when the skill is activated",[1023,1076,1077,1082,1085],{},[1038,1078,1079],{},[773,1080,1081],{},"Format",[1038,1083,1084],{},"Plain text with links",[1038,1086,1087],{},"Markdown with YAML frontmatter",[1023,1089,1090,1095,1098],{},[1038,1091,1092],{},[773,1093,1094],{},"Best for",[1038,1096,1097],{},"Helping agents find information",[1038,1099,1100],{},"Teaching agents how to use your product",[520,1102,1103,1104,1106],{},"Use both together: ",[143,1105,1014],{}," tells agents where to find information, while skills tell agents what they can accomplish and how.",[1108,1109,1110],"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":1112},[1113,1114,1120,1121,1122,1123,1124,1125,1129],{"id":136,"depth":216,"text":137},{"id":177,"depth":216,"text":178,"children":1115},[1116,1117,1118,1119],{"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":532,"depth":216,"text":53},{"id":627,"depth":216,"text":628},{"id":678,"depth":216,"text":679},{"id":763,"depth":216,"text":764},{"id":812,"depth":216,"text":813,"children":1126},[1127,1128],{"id":843,"depth":226,"text":844},{"id":979,"depth":226,"text":980},{"id":1007,"depth":216,"text":1008},"Publish agent skills from your documentation site so AI tools can discover and install them automatically.",null,{},{"icon":122},{"title":119,"description":1130},"p6GMnbAqwo2V6wAfwKBX4LIO3b0F37Ki90VVJf90YSY",[1137,1139],{"title":114,"path":115,"stem":116,"description":1138,"icon":117,"children":-1},"Connect your documentation to AI tools with a native MCP server.",{"title":124,"path":125,"stem":126,"description":1140,"icon":127,"children":-1},"Docus generate AI-ready content files using Nuxt LLMs module",1776778184284]