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