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