[{"data":1,"prerenderedAt":1517},["ShallowReactive",2],{"navigation":3,"\u002Fen\u002Fhow-to\u002Fskills":129,"\u002Fen\u002Fhow-to\u002Fskills-surround":1512},[4,68],{"title":5,"path":6,"stem":7,"children":8,"page":22},"En","\u002Fen","en",[9,13,23],{"title":10,"path":11,"stem":12},"Product Overview","\u002Fen\u002Fintroduction","en\u002F0.introduction",{"title":14,"path":15,"stem":16,"children":17,"page":22},"Tutorials","\u002Fen\u002Ftutorials","en\u002F1.tutorials",[18],{"title":19,"path":20,"stem":21},"Quick Start","\u002Fen\u002Ftutorials\u002Fquickstart","en\u002F1.tutorials\u002Fquickstart",false,{"title":24,"path":25,"stem":26,"children":27,"page":22},"How To","\u002Fen\u002Fhow-to","en\u002F2.how-to",[28,32,36,40,44,48,52,56,60,64],{"title":29,"path":30,"stem":31},"Canvas Workspace","\u002Fen\u002Fhow-to\u002Fcanvas","en\u002F2.how-to\u002Fcanvas",{"title":33,"path":34,"stem":35},"Configuration","\u002Fen\u002Fhow-to\u002Fconfigure","en\u002F2.how-to\u002Fconfigure",{"title":37,"path":38,"stem":39},"Scheduled Tasks","\u002Fen\u002Fhow-to\u002Fcron-jobs","en\u002F2.how-to\u002Fcron-jobs",{"title":41,"path":42,"stem":43},"Configuring System Service","\u002Fen\u002Fhow-to\u002Finstall","en\u002F2.how-to\u002Finstall",{"title":45,"path":46,"stem":47},"Managing Instructions","\u002Fen\u002Fhow-to\u002Finstructions","en\u002F2.how-to\u002Finstructions",{"title":49,"path":50,"stem":51},"MCP Servers","\u002Fen\u002Fhow-to\u002Fmcp-servers","en\u002F2.how-to\u002Fmcp-servers",{"title":53,"path":54,"stem":55},"Managing Profiles","\u002Fen\u002Fhow-to\u002Fprofiles","en\u002F2.how-to\u002Fprofiles",{"title":57,"path":58,"stem":59},"Configuring Runtimes","\u002Fen\u002Fhow-to\u002Fruntimes","en\u002F2.how-to\u002Fruntimes",{"title":61,"path":62,"stem":63},"Managing Skills","\u002Fen\u002Fhow-to\u002Fskills","en\u002F2.how-to\u002Fskills",{"title":65,"path":66,"stem":67},"VS Code Integration","\u002Fen\u002Fhow-to\u002Fvscode","en\u002F2.how-to\u002Fvscode",{"title":69,"path":70,"stem":71,"children":72,"page":22},"Zh","\u002Fzh","zh",[73,77,85],{"title":74,"path":75,"stem":76},"产品概述","\u002Fzh\u002Fintroduction","zh\u002F0.introduction",{"title":14,"path":78,"stem":79,"children":80,"page":22},"\u002Fzh\u002Ftutorials","zh\u002F1.tutorials",[81],{"title":82,"path":83,"stem":84},"快速开始","\u002Fzh\u002Ftutorials\u002Fquickstart","zh\u002F1.tutorials\u002Fquickstart",{"title":24,"path":86,"stem":87,"children":88,"page":22},"\u002Fzh\u002Fhow-to","zh\u002F2.how-to",[89,93,97,101,105,109,113,117,121,125],{"title":90,"path":91,"stem":92},"Canvas 工作区","\u002Fzh\u002Fhow-to\u002Fcanvas","zh\u002F2.how-to\u002Fcanvas",{"title":94,"path":95,"stem":96},"配置","\u002Fzh\u002Fhow-to\u002Fconfigure","zh\u002F2.how-to\u002Fconfigure",{"title":98,"path":99,"stem":100},"定时任务","\u002Fzh\u002Fhow-to\u002Fcron-jobs","zh\u002F2.how-to\u002Fcron-jobs",{"title":102,"path":103,"stem":104},"配置系统服务","\u002Fzh\u002Fhow-to\u002Finstall","zh\u002F2.how-to\u002Finstall",{"title":106,"path":107,"stem":108},"管理指令文件","\u002Fzh\u002Fhow-to\u002Finstructions","zh\u002F2.how-to\u002Finstructions",{"title":110,"path":111,"stem":112},"MCP 服务器","\u002Fzh\u002Fhow-to\u002Fmcp-servers","zh\u002F2.how-to\u002Fmcp-servers",{"title":114,"path":115,"stem":116},"管理 Profile","\u002Fzh\u002Fhow-to\u002Fprofiles","zh\u002F2.how-to\u002Fprofiles",{"title":118,"path":119,"stem":120},"配置 Runtime","\u002Fzh\u002Fhow-to\u002Fruntimes","zh\u002F2.how-to\u002Fruntimes",{"title":122,"path":123,"stem":124},"管理 Skill","\u002Fzh\u002Fhow-to\u002Fskills","zh\u002F2.how-to\u002Fskills",{"title":126,"path":127,"stem":128},"VS Code 集成","\u002Fzh\u002Fhow-to\u002Fvscode","zh\u002F2.how-to\u002Fvscode",{"id":130,"title":61,"body":131,"description":1506,"extension":1507,"links":1508,"meta":1509,"navigation":280,"path":62,"seo":1510,"stem":63,"__hash__":1511},"docs\u002Fen\u002F2.how-to\u002Fskills.md",{"type":132,"value":133,"toc":1476},"minimark",[134,138,143,151,173,176,187,190,194,197,208,213,219,360,365,496,505,519,523,526,530,533,537,544,564,567,583,592,596,599,603,606,684,687,691,694,765,769,776,841,845,848,862,865,881,885,888,892,895,962,966,973,979,1009,1012,1018,1063,1066,1089,1093,1097,1105,1132,1135,1139,1142,1152,1175,1179,1183,1254,1258,1273,1277,1291,1294,1298,1302,1307,1366,1370,1373,1434,1441,1445,1472],[135,136,137],"p",{},"A Skill is a capability description and usage guide written for agents.\nThis guide explains how to install, manage, and use Skills in tasks.",[139,140,142],"h2",{"id":141},"what-is-a-skill","What is a Skill?",[135,144,145,146,150],{},"A Skill is not a tool itself, but rather ",[147,148,149],"strong",{},"documentation and best\npractices about tools",". It contains:",[152,153,154,161,167],"ul",{},[155,156,157,160],"li",{},[147,158,159],{},"Capability description",": What this Skill does",[155,162,163,166],{},[147,164,165],{},"Usage guide",": When agents should use it and how to use it most\neffectively",[155,168,169,172],{},[147,170,171],{},"Reference materials",": API documentation, example code, common\nerrors and solutions",[135,174,175],{},"For example, a “Docker Operations” Skill tells an agent how to:",[152,177,178,181,184],{},[155,179,180],{},"Build images, run containers, view logs",[155,182,183],{},"Handle common Docker errors",[155,185,186],{},"Follow Dockerfile best practices",[135,188,189],{},"When you create a task, you select a Profile, and the agent\nautomatically gets all Skills associated with that Profile.",[139,191,193],{"id":192},"skill-directory-structure","Skill directory structure",[135,195,196],{},"Each Skill is a directory with a standardized structure:",[198,199,204],"pre",{"className":200,"code":202,"language":203},[201],"language-text","skills\u002F\n  docker-ops\u002F              # Skill ID (directory name)\n    SKILL.md               # Skill metadata + content\n    references\u002F            # Optional reference materials directory\n      api.md               # Reference documentation\n      examples.md\n","text",[205,206,202],"code",{"__ignoreMap":207},"",[209,210,212],"h3",{"id":211},"skillmd-file-format","SKILL.md file format",[135,214,215,218],{},[205,216,217],{},"SKILL.md"," contains YAML frontmatter and Markdown body:",[198,220,224],{"className":221,"code":222,"language":223,"meta":207,"style":207},"language-markdown shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","---\nname: docker-ops\ndescription: Guide to Docker image, container, and network management\nlicense: MIT\nmetadata:\n  disabled: false\n  contentOverrideMode: replace\n---\n\n## Overview\n\nThis Skill guides agents how to use Docker for common tasks...\n\n## Core concepts\n\n- **Image**: Read-only template containing application and dependencies\n- **Container**: Running instance of an image\n\n## Usage guide\n\n### Build images\n\n...\n","markdown",[205,225,226,234,240,246,252,258,264,270,275,282,288,293,299,304,310,315,321,327,332,338,343,349,354],{"__ignoreMap":207},[227,228,231],"span",{"class":229,"line":230},"line",1,[227,232,233],{},"---\n",[227,235,237],{"class":229,"line":236},2,[227,238,239],{},"name: docker-ops\n",[227,241,243],{"class":229,"line":242},3,[227,244,245],{},"description: Guide to Docker image, container, and network management\n",[227,247,249],{"class":229,"line":248},4,[227,250,251],{},"license: MIT\n",[227,253,255],{"class":229,"line":254},5,[227,256,257],{},"metadata:\n",[227,259,261],{"class":229,"line":260},6,[227,262,263],{},"  disabled: false\n",[227,265,267],{"class":229,"line":266},7,[227,268,269],{},"  contentOverrideMode: replace\n",[227,271,273],{"class":229,"line":272},8,[227,274,233],{},[227,276,278],{"class":229,"line":277},9,[227,279,281],{"emptyLinePlaceholder":280},true,"\n",[227,283,285],{"class":229,"line":284},10,[227,286,287],{},"## Overview\n",[227,289,291],{"class":229,"line":290},11,[227,292,281],{"emptyLinePlaceholder":280},[227,294,296],{"class":229,"line":295},12,[227,297,298],{},"This Skill guides agents how to use Docker for common tasks...\n",[227,300,302],{"class":229,"line":301},13,[227,303,281],{"emptyLinePlaceholder":280},[227,305,307],{"class":229,"line":306},14,[227,308,309],{},"## Core concepts\n",[227,311,313],{"class":229,"line":312},15,[227,314,281],{"emptyLinePlaceholder":280},[227,316,318],{"class":229,"line":317},16,[227,319,320],{},"- **Image**: Read-only template containing application and dependencies\n",[227,322,324],{"class":229,"line":323},17,[227,325,326],{},"- **Container**: Running instance of an image\n",[227,328,330],{"class":229,"line":329},18,[227,331,281],{"emptyLinePlaceholder":280},[227,333,335],{"class":229,"line":334},19,[227,336,337],{},"## Usage guide\n",[227,339,341],{"class":229,"line":340},20,[227,342,281],{"emptyLinePlaceholder":280},[227,344,346],{"class":229,"line":345},21,[227,347,348],{},"### Build images\n",[227,350,352],{"class":229,"line":351},22,[227,353,281],{"emptyLinePlaceholder":280},[227,355,357],{"class":229,"line":356},23,[227,358,359],{},"...\n",[361,362,364],"h4",{"id":363},"frontmatter-fields","Frontmatter fields",[366,367,368,384],"table",{},[369,370,371],"thead",{},[372,373,374,378,381],"tr",{},[375,376,377],"th",{},"Field",[375,379,380],{},"Required",[375,382,383],{},"Description",[385,386,387,401,414,426,445,469,484],"tbody",{},[372,388,389,395,398],{},[390,391,392],"td",{},[205,393,394],{},"name",[390,396,397],{},"Yes",[390,399,400],{},"Display name",[372,402,403,408,411],{},[390,404,405],{},[205,406,407],{},"description",[390,409,410],{},"No",[390,412,413],{},"Short description",[372,415,416,421,423],{},[390,417,418],{},[205,419,420],{},"license",[390,422,410],{},[390,424,425],{},"License",[372,427,428,433,435],{},[390,429,430],{},[205,431,432],{},"metadata.disabled",[390,434,410],{},[390,436,437,438,441,442],{},"Disable this Skill; value is ",[205,439,440],{},"false"," (default) or ",[205,443,444],{},"true",[372,446,447,452,454],{},[390,448,449],{},[205,450,451],{},"metadata.inclusion",[390,453,410],{},[390,455,456,457,460,461,464,465,468],{},"Inclusion policy: ",[205,458,459],{},"auto"," (default) — auto-included, overridable by higher layers; ",[205,462,463],{},"mandatory"," — forced inclusion, cannot be removed; ",[205,466,467],{},"explicit"," — only effective when explicitly referenced in a Profile",[372,470,471,476,478],{},[390,472,473],{},[205,474,475],{},"metadata.overridable",[390,477,410],{},[390,479,480,481,483],{},"Whether higher-priority config layers can override this resource (default: not set — overrides are allowed). When explicitly set to ",[205,482,440],{},", same-named entries in higher-priority layers are ignored",[372,485,486,491,493],{},[390,487,488],{},[205,489,490],{},"metadata.contentOverrideMode",[390,492,410],{},[390,494,495],{},"Merge strategy for same-ID Skills across layers; see below",[135,497,498,504],{},[147,499,500,503],{},[205,501,502],{},"contentOverrideMode"," explanation",":",[152,506,507,513],{},[155,508,509,512],{},[205,510,511],{},"replace"," (default): Use content from the highest priority layer,\nignore lower layers",[155,514,515,518],{},[205,516,517],{},"merge",": Chain fallback by priority (fall back to lower layer if not\npresent in higher layer)",[139,520,522],{"id":521},"install-skills","Install Skills",[135,524,525],{},"Skills can come from three sources:",[209,527,529],{"id":528},"_1-built-in-skills","1. Built-in Skills",[135,531,532],{},"Sink includes some commonly used Skills. These are automatically\navailable without additional installation.",[209,534,536],{"id":535},"_2-sync-from-official-repository","2. Sync from official repository",[135,538,539,540,543],{},"Sync pre-downloaded Skills from the ",[205,541,542],{},"~\u002F.agents\u002Fskills\u002F"," directory:",[198,545,549],{"className":546,"code":547,"language":548,"meta":207,"style":207},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","sink skill sync\n","bash",[205,550,551],{"__ignoreMap":207},[227,552,553,557,561],{"class":229,"line":230},[227,554,556],{"class":555},"sBMFI","sink",[227,558,560],{"class":559},"sfazB"," skill",[227,562,563],{"class":559}," sync\n",[135,565,566],{},"This command will:",[152,568,569,574],{},[155,570,571,572],{},"Scan all Skill directories under ",[205,573,542],{},[155,575,576,577,580,581],{},"Create symlinks in the ",[205,578,579],{},"skills\u002F"," subdirectory in your Sink\nconfiguration directory pointing to ",[205,582,542],{},[135,584,585,588,589,591],{},[147,586,587],{},"Prerequisite",": You need to download Skill folders to\n",[205,590,542],{}," beforehand.",[209,593,595],{"id":594},"_3-add-skills-manually","3. Add Skills manually",[135,597,598],{},"Create Skill folders directly in your configuration directory:",[361,600,602],{"id":601},"user-level-installation","User-level installation",[135,604,605],{},"Place Skills in the user-level configuration directory:",[198,607,609],{"className":546,"code":608,"language":548,"meta":207,"style":207},"mkdir -p ~\u002F.sink\u002Fskills\u002Fmy-custom-skill\ncat > ~\u002F.sink\u002Fskills\u002Fmy-custom-skill\u002FSKILL.md \u003C\u003C 'SKILL'\n---\nname: my-custom-skill\ndescription: Custom tutorial\nmetadata:\n  disabled: false\n---\n\n## Overview\nThis is a custom Skill I wrote for agents...\nSKILL\n",[205,610,611,622,640,644,649,654,658,662,666,670,674,679],{"__ignoreMap":207},[227,612,613,616,619],{"class":229,"line":230},[227,614,615],{"class":555},"mkdir",[227,617,618],{"class":559}," -p",[227,620,621],{"class":559}," ~\u002F.sink\u002Fskills\u002Fmy-custom-skill\n",[227,623,624,627,631,634,637],{"class":229,"line":236},[227,625,626],{"class":555},"cat",[227,628,630],{"class":629},"sMK4o"," >",[227,632,633],{"class":559}," ~\u002F.sink\u002Fskills\u002Fmy-custom-skill\u002FSKILL.md",[227,635,636],{"class":629}," \u003C\u003C",[227,638,639],{"class":629}," 'SKILL'\n",[227,641,642],{"class":229,"line":242},[227,643,233],{"class":559},[227,645,646],{"class":229,"line":248},[227,647,648],{"class":559},"name: my-custom-skill\n",[227,650,651],{"class":229,"line":254},[227,652,653],{"class":559},"description: Custom tutorial\n",[227,655,656],{"class":229,"line":260},[227,657,257],{"class":559},[227,659,660],{"class":229,"line":266},[227,661,263],{"class":559},[227,663,664],{"class":229,"line":272},[227,665,233],{"class":559},[227,667,668],{"class":229,"line":277},[227,669,281],{"emptyLinePlaceholder":280},[227,671,672],{"class":229,"line":284},[227,673,287],{"class":559},[227,675,676],{"class":229,"line":290},[227,677,678],{"class":559},"This is a custom Skill I wrote for agents...\n",[227,680,681],{"class":229,"line":295},[227,682,683],{"class":629},"SKILL\n",[135,685,686],{},"This Skill will be available to all workspaces.",[361,688,690],{"id":689},"workspace-level-installation","Workspace-level installation",[135,692,693],{},"Place Skills in the workspace configuration directory to apply only to\nthat workspace:",[198,695,697],{"className":546,"code":696,"language":548,"meta":207,"style":207},"mkdir -p \u002Fpath\u002Fto\u002Fmy-project\u002Fsink\u002Fskills\u002Fproject-specific-skill\ncat > \u002Fpath\u002Fto\u002Fmy-project\u002Fsink\u002Fskills\u002Fproject-specific-skill\u002FSKILL.md \u003C\u003C 'SKILL'\n---\nname: project-specific-skill\ndescription: Available only in this project\nmetadata:\n  disabled: false\n---\n\n## Project background\nDescribe project-specific practices and conventions in this Skill...\nSKILL\n",[205,698,699,708,721,725,730,735,739,743,747,751,756,761],{"__ignoreMap":207},[227,700,701,703,705],{"class":229,"line":230},[227,702,615],{"class":555},[227,704,618],{"class":559},[227,706,707],{"class":559}," \u002Fpath\u002Fto\u002Fmy-project\u002Fsink\u002Fskills\u002Fproject-specific-skill\n",[227,709,710,712,714,717,719],{"class":229,"line":236},[227,711,626],{"class":555},[227,713,630],{"class":629},[227,715,716],{"class":559}," \u002Fpath\u002Fto\u002Fmy-project\u002Fsink\u002Fskills\u002Fproject-specific-skill\u002FSKILL.md",[227,718,636],{"class":629},[227,720,639],{"class":629},[227,722,723],{"class":229,"line":242},[227,724,233],{"class":559},[227,726,727],{"class":229,"line":248},[227,728,729],{"class":559},"name: project-specific-skill\n",[227,731,732],{"class":229,"line":254},[227,733,734],{"class":559},"description: Available only in this project\n",[227,736,737],{"class":229,"line":260},[227,738,257],{"class":559},[227,740,741],{"class":229,"line":266},[227,742,263],{"class":559},[227,744,745],{"class":229,"line":272},[227,746,233],{"class":559},[227,748,749],{"class":229,"line":277},[227,750,281],{"emptyLinePlaceholder":280},[227,752,753],{"class":229,"line":284},[227,754,755],{"class":559},"## Project background\n",[227,757,758],{"class":229,"line":290},[227,759,760],{"class":559},"Describe project-specific practices and conventions in this Skill...\n",[227,762,763],{"class":229,"line":295},[227,764,683],{"class":629},[209,766,768],{"id":767},"_4-add-reference-materials","4. Add reference materials",[135,770,771,772,775],{},"Create a ",[205,773,774],{},"references\u002F"," subdirectory in the Skill directory to store\nadditional documentation:",[198,777,779],{"className":546,"code":778,"language":548,"meta":207,"style":207},"mkdir -p ~\u002F.sink\u002Fskills\u002Fdocker-ops\u002Freferences\ncat > ~\u002F.sink\u002Fskills\u002Fdocker-ops\u002Freferences\u002Fapi.md \u003C\u003C 'REF'\n# Docker API Reference\n\n## Common commands\n\n- `docker build` - Build image\n- `docker run` - Run container\n...\nREF\n",[205,780,781,790,804,809,813,818,822,827,832,836],{"__ignoreMap":207},[227,782,783,785,787],{"class":229,"line":230},[227,784,615],{"class":555},[227,786,618],{"class":559},[227,788,789],{"class":559}," ~\u002F.sink\u002Fskills\u002Fdocker-ops\u002Freferences\n",[227,791,792,794,796,799,801],{"class":229,"line":236},[227,793,626],{"class":555},[227,795,630],{"class":629},[227,797,798],{"class":559}," ~\u002F.sink\u002Fskills\u002Fdocker-ops\u002Freferences\u002Fapi.md",[227,800,636],{"class":629},[227,802,803],{"class":629}," 'REF'\n",[227,805,806],{"class":229,"line":242},[227,807,808],{"class":559},"# Docker API Reference\n",[227,810,811],{"class":229,"line":248},[227,812,281],{"emptyLinePlaceholder":280},[227,814,815],{"class":229,"line":254},[227,816,817],{"class":559},"## Common commands\n",[227,819,820],{"class":229,"line":260},[227,821,281],{"emptyLinePlaceholder":280},[227,823,824],{"class":229,"line":266},[227,825,826],{"class":559},"- `docker build` - Build image\n",[227,828,829],{"class":229,"line":272},[227,830,831],{"class":559},"- `docker run` - Run container\n",[227,833,834],{"class":229,"line":277},[227,835,359],{"class":559},[227,837,838],{"class":229,"line":284},[227,839,840],{"class":629},"REF\n",[139,842,844],{"id":843},"view-installed-skills","View installed Skills",[135,846,847],{},"List all currently available Skills:",[198,849,851],{"className":546,"code":850,"language":548,"meta":207,"style":207},"sink skill list\n",[205,852,853],{"__ignoreMap":207},[227,854,855,857,859],{"class":229,"line":230},[227,856,556],{"class":555},[227,858,560],{"class":559},[227,860,861],{"class":559}," list\n",[135,863,864],{},"Output will show:",[152,866,867,870,873,875,878],{},[155,868,869],{},"Skill ID (directory name)",[155,871,872],{},"Display name (from frontmatter)",[155,874,383],{},[155,876,877],{},"Source (builtin \u002F user \u002F workspace)",[155,879,880],{},"Enable status",[139,882,884],{"id":883},"associate-skills-with-profiles","Associate Skills with Profiles",[135,886,887],{},"Skills are linked to agents through Profiles. Once a task is created,\nthe agent automatically gets all Skills associated with that Profile.",[209,889,891],{"id":890},"edit-a-profile","Edit a Profile",[135,893,894],{},"Open the Profile file (Markdown format) and specify Skills in the\nfrontmatter:",[198,896,898],{"className":221,"code":897,"language":223,"meta":207,"style":207},"---\nname: code-reviewer\ndescription: Code quality analysis and review\nruntime: claude-code\nskills:\n  - web-search\n  - code-analysis\n  - test-runner\nmcpServers:\n  - filesystem\n---\n\nYou are an experienced code reviewer specializing in software quality...\n",[205,899,900,904,909,914,919,924,929,934,939,944,949,953,957],{"__ignoreMap":207},[227,901,902],{"class":229,"line":230},[227,903,233],{},[227,905,906],{"class":229,"line":236},[227,907,908],{},"name: code-reviewer\n",[227,910,911],{"class":229,"line":242},[227,912,913],{},"description: Code quality analysis and review\n",[227,915,916],{"class":229,"line":248},[227,917,918],{},"runtime: claude-code\n",[227,920,921],{"class":229,"line":254},[227,922,923],{},"skills:\n",[227,925,926],{"class":229,"line":260},[227,927,928],{},"  - web-search\n",[227,930,931],{"class":229,"line":266},[227,932,933],{},"  - code-analysis\n",[227,935,936],{"class":229,"line":272},[227,937,938],{},"  - test-runner\n",[227,940,941],{"class":229,"line":277},[227,942,943],{},"mcpServers:\n",[227,945,946],{"class":229,"line":284},[227,947,948],{},"  - filesystem\n",[227,950,951],{"class":229,"line":290},[227,952,233],{},[227,954,955],{"class":229,"line":295},[227,956,281],{"emptyLinePlaceholder":280},[227,958,959],{"class":229,"line":301},[227,960,961],{},"You are an experienced code reviewer specializing in software quality...\n",[361,963,965],{"id":964},"skills-field","Skills field",[135,967,968,969,972],{},"The ",[205,970,971],{},"skills"," field supports two syntaxes:",[135,974,975,978],{},[147,976,977],{},"Simple list"," (whitelist):",[198,980,984],{"className":981,"code":982,"language":983,"meta":207,"style":207},"language-yaml shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","skills:\n  - web-search\n  - docker-ops\n","yaml",[205,985,986,994,1002],{"__ignoreMap":207},[227,987,988,991],{"class":229,"line":230},[227,989,971],{"class":990},"swJcz",[227,992,993],{"class":629},":\n",[227,995,996,999],{"class":229,"line":236},[227,997,998],{"class":629},"  -",[227,1000,1001],{"class":559}," web-search\n",[227,1003,1004,1006],{"class":229,"line":242},[227,1005,998],{"class":629},[227,1007,1008],{"class":559}," docker-ops\n",[135,1010,1011],{},"Only Skills in the list are available.",[135,1013,1014,1017],{},[147,1015,1016],{},"Selector syntax"," (include\u002Fexclude):",[198,1019,1021],{"className":981,"code":1020,"language":983,"meta":207,"style":207},"skills:\n  include:\n    - web-search\n    - docker-ops\n  exclude:\n    - experimental-skill\n",[205,1022,1023,1029,1036,1043,1049,1056],{"__ignoreMap":207},[227,1024,1025,1027],{"class":229,"line":230},[227,1026,971],{"class":990},[227,1028,993],{"class":629},[227,1030,1031,1034],{"class":229,"line":236},[227,1032,1033],{"class":990},"  include",[227,1035,993],{"class":629},[227,1037,1038,1041],{"class":229,"line":242},[227,1039,1040],{"class":629},"    -",[227,1042,1001],{"class":559},[227,1044,1045,1047],{"class":229,"line":248},[227,1046,1040],{"class":629},[227,1048,1008],{"class":559},[227,1050,1051,1054],{"class":229,"line":254},[227,1052,1053],{"class":990},"  exclude",[227,1055,993],{"class":629},[227,1057,1058,1060],{"class":229,"line":260},[227,1059,1040],{"class":629},[227,1061,1062],{"class":559}," experimental-skill\n",[135,1064,1065],{},"Or exclude only:",[198,1067,1069],{"className":981,"code":1068,"language":983,"meta":207,"style":207},"skills:\n  exclude:\n    - experimental-skill\n",[205,1070,1071,1077,1083],{"__ignoreMap":207},[227,1072,1073,1075],{"class":229,"line":230},[227,1074,971],{"class":990},[227,1076,993],{"class":629},[227,1078,1079,1081],{"class":229,"line":236},[227,1080,1053],{"class":990},[227,1082,993],{"class":629},[227,1084,1085,1087],{"class":229,"line":242},[227,1086,1040],{"class":629},[227,1088,1062],{"class":559},[139,1090,1092],{"id":1091},"disable-skills","Disable Skills",[209,1094,1096],{"id":1095},"temporary-disable","Temporary disable",[135,1098,1099,1100,1102,1103,504],{},"Modify the Skill’s frontmatter and set ",[205,1101,432],{}," to ",[205,1104,444],{},[198,1106,1108],{"className":221,"code":1107,"language":223,"meta":207,"style":207},"---\nname: web-search\nmetadata:\n  disabled: true\n---\n",[205,1109,1110,1114,1119,1123,1128],{"__ignoreMap":207},[227,1111,1112],{"class":229,"line":230},[227,1113,233],{},[227,1115,1116],{"class":229,"line":236},[227,1117,1118],{},"name: web-search\n",[227,1120,1121],{"class":229,"line":242},[227,1122,257],{},[227,1124,1125],{"class":229,"line":248},[227,1126,1127],{},"  disabled: true\n",[227,1129,1130],{"class":229,"line":254},[227,1131,233],{},[135,1133,1134],{},"After disabling, the Skill will be removed from the available Skills\nlist for all Profiles.",[209,1136,1138],{"id":1137},"exclude-from-specific-profiles","Exclude from specific Profiles",[135,1140,1141],{},"If you don’t want to disable globally but only exclude from certain\nProfiles:",[135,1143,1144,1145,1148,1149,1151],{},"Use ",[205,1146,1147],{},"exclude"," in the Profile’s ",[205,1150,971],{}," field:",[198,1153,1155],{"className":981,"code":1154,"language":983,"meta":207,"style":207},"skills:\n  exclude:\n    - web-search\n",[205,1156,1157,1163,1169],{"__ignoreMap":207},[227,1158,1159,1161],{"class":229,"line":230},[227,1160,971],{"class":990},[227,1162,993],{"class":629},[227,1164,1165,1167],{"class":229,"line":236},[227,1166,1053],{"class":990},[227,1168,993],{"class":629},[227,1170,1171,1173],{"class":229,"line":242},[227,1172,1040],{"class":629},[227,1174,1001],{"class":559},[139,1176,1178],{"id":1177},"best-practices","Best practices",[209,1180,1182],{"id":1181},"write-clear-skills","Write clear Skills",[1184,1185,1186,1206,1245],"ol",{},[155,1187,1188,1191,1192],{},[147,1189,1190],{},"Clear titles",": Skill names should intuitively reflect their\npurpose",[198,1193,1195],{"className":981,"code":1194,"language":983,"meta":207,"style":207},"name: error-fixing-and-debugging\n",[205,1196,1197],{"__ignoreMap":207},[227,1198,1199,1201,1203],{"class":229,"line":230},[227,1200,394],{"class":990},[227,1202,504],{"class":629},[227,1204,1205],{"class":559}," error-fixing-and-debugging\n",[155,1207,1208,1211,1212],{},[147,1209,1210],{},"Include specific examples",": Good Skills include code examples and\ncommon errors",[198,1213,1215],{"className":221,"code":1214,"language":223,"meta":207,"style":207},"## Common errors\n\n### Error: Connection refused\n\n**Cause**: Service not started\n**Solution**: Run `docker run -d my-service`\n",[205,1216,1217,1222,1226,1231,1235,1240],{"__ignoreMap":207},[227,1218,1219],{"class":229,"line":230},[227,1220,1221],{},"## Common errors\n",[227,1223,1224],{"class":229,"line":236},[227,1225,281],{"emptyLinePlaceholder":280},[227,1227,1228],{"class":229,"line":242},[227,1229,1230],{},"### Error: Connection refused\n",[227,1232,1233],{"class":229,"line":248},[227,1234,281],{"emptyLinePlaceholder":280},[227,1236,1237],{"class":229,"line":254},[227,1238,1239],{},"**Cause**: Service not started\n",[227,1241,1242],{"class":229,"line":260},[227,1243,1244],{},"**Solution**: Run `docker run -d my-service`\n",[155,1246,1247,1250,1251,1253],{},[147,1248,1249],{},"Organize reference materials",": Complex Skills should organize\ndocumentation in categorized ",[205,1252,774],{}," directory",[209,1255,1257],{"id":1256},"sharing-and-version-management","Sharing and version management",[1184,1259,1260,1263,1270],{},[155,1261,1262],{},"Store Skills in version control (Git)",[155,1264,1265,1266,1269],{},"Use semantic versioning (e.g., ",[205,1267,1268],{},"v1.0.0",") to tag releases",[155,1271,1272],{},"Explicitly document dependent Skill versions in Profiles (if needed)",[209,1274,1276],{"id":1275},"difference-between-skills-and-mcp-servers","Difference between Skills and MCP Servers",[152,1278,1279,1285],{},[155,1280,1281,1284],{},[147,1282,1283],{},"Skill"," = Guide and best practices documentation",[155,1286,1287,1290],{},[147,1288,1289],{},"MCP Server"," = Actual tool and capability implementation",[135,1292,1293],{},"Agents rely on MCP Servers to execute operations, and on Skills to\nunderstand “when to use” and “how to use well.” The two are\ncomplementary.",[139,1295,1297],{"id":1296},"troubleshooting","Troubleshooting",[209,1299,1301],{"id":1300},"skill-not-showing-in-profile","Skill not showing in Profile",[135,1303,1304,504],{},[147,1305,1306],{},"Checklist",[1184,1308,1309,1322,1342],{},[155,1310,1311,1312],{},"Is the Skill disabled?",[198,1313,1315],{"className":546,"code":1314,"language":548,"meta":207,"style":207},"# Check metadata.disabled in SKILL.md\n",[205,1316,1317],{"__ignoreMap":207},[227,1318,1319],{"class":229,"line":230},[227,1320,1314],{"class":1321},"sHwdD",[155,1323,1324,1325],{},"Is the Skill ID correct?",[198,1326,1328],{"className":546,"code":1327,"language":548,"meta":207,"style":207},"sink skill list  # View actual Skill IDs\n",[205,1329,1330],{"__ignoreMap":207},[227,1331,1332,1334,1336,1339],{"class":229,"line":230},[227,1333,556],{"class":555},[227,1335,560],{"class":559},[227,1337,1338],{"class":559}," list",[227,1340,1341],{"class":1321},"  # View actual Skill IDs\n",[155,1343,1344,1345],{},"Is the Skill reference in the Profile spelled correctly?",[198,1346,1348],{"className":981,"code":1347,"language":983,"meta":207,"style":207},"skills:\n  - correct-skill-id # Must match skill list output\n",[205,1349,1350,1356],{"__ignoreMap":207},[227,1351,1352,1354],{"class":229,"line":230},[227,1353,971],{"class":990},[227,1355,993],{"class":629},[227,1357,1358,1360,1363],{"class":229,"line":236},[227,1359,998],{"class":629},[227,1361,1362],{"class":559}," correct-skill-id",[227,1364,1365],{"class":1321}," # Must match skill list output\n",[209,1367,1369],{"id":1368},"multi-layer-skill-conflicts","Multi-layer Skill conflicts",[135,1371,1372],{},"If you define the same Skill ID in both user and workspace layers and\nsee unexpected content, check:",[198,1374,1376],{"className":546,"code":1375,"language":548,"meta":207,"style":207},"# View effective configuration (merged)\ncat \u003Cworkspace>\u002F.sink\u002F.settings.snapshot.json\n\n# View raw files\ncat ~\u002F.sink\u002Fskills\u002Fmy-skill\u002FSKILL.md\ncat \u003Cworkspace>\u002F.sink\u002Fskills\u002Fmy-skill\u002FSKILL.md\n",[205,1377,1378,1383,1403,1407,1412,1419],{"__ignoreMap":207},[227,1379,1380],{"class":229,"line":230},[227,1381,1382],{"class":1321},"# View effective configuration (merged)\n",[227,1384,1385,1387,1390,1393,1397,1400],{"class":229,"line":236},[227,1386,626],{"class":555},[227,1388,1389],{"class":629}," \u003C",[227,1391,1392],{"class":559},"workspac",[227,1394,1396],{"class":1395},"sTEyZ","e",[227,1398,1399],{"class":629},">",[227,1401,1402],{"class":559},"\u002F.sink\u002F.settings.snapshot.json\n",[227,1404,1405],{"class":229,"line":242},[227,1406,281],{"emptyLinePlaceholder":280},[227,1408,1409],{"class":229,"line":248},[227,1410,1411],{"class":1321},"# View raw files\n",[227,1413,1414,1416],{"class":229,"line":254},[227,1415,626],{"class":555},[227,1417,1418],{"class":559}," ~\u002F.sink\u002Fskills\u002Fmy-skill\u002FSKILL.md\n",[227,1420,1421,1423,1425,1427,1429,1431],{"class":229,"line":260},[227,1422,626],{"class":555},[227,1424,1389],{"class":629},[227,1426,1392],{"class":559},[227,1428,1396],{"class":1395},[227,1430,1399],{"class":629},[227,1432,1433],{"class":559},"\u002F.sink\u002Fskills\u002Fmy-skill\u002FSKILL.md\n",[135,1435,1436,1437,1440],{},"Priority is ",[147,1438,1439],{},"workspace > user > builtin",".",[139,1442,1444],{"id":1443},"next-steps","Next steps",[152,1446,1447,1456,1464],{},[155,1448,1449,1450,1455],{},"Learn how to ",[1451,1452,1454],"a",{"href":1453},".\u002Fprofiles","Manage Profiles"," to associate Skills with\nagents",[155,1457,1458,1459,1463],{},"See ",[1451,1460,1462],{"href":1461},".\u002Fmcp-servers","Configure MCP Servers"," to add actual tools to\nagents",[155,1465,1466,1467,1471],{},"Create your first ",[1451,1468,1470],{"href":1469},"..\u002Ftutorials\u002Fquickstart","Task"," and have agents\nuse the Skills you configured",[1473,1474,1475],"style",{},"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 .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 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 .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 .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}",{"title":207,"searchDepth":230,"depth":236,"links":1477},[1478,1479,1482,1488,1489,1492,1496,1501,1505],{"id":141,"depth":236,"text":142},{"id":192,"depth":236,"text":193,"children":1480},[1481],{"id":211,"depth":242,"text":212},{"id":521,"depth":236,"text":522,"children":1483},[1484,1485,1486,1487],{"id":528,"depth":242,"text":529},{"id":535,"depth":242,"text":536},{"id":594,"depth":242,"text":595},{"id":767,"depth":242,"text":768},{"id":843,"depth":236,"text":844},{"id":883,"depth":236,"text":884,"children":1490},[1491],{"id":890,"depth":242,"text":891},{"id":1091,"depth":236,"text":1092,"children":1493},[1494,1495],{"id":1095,"depth":242,"text":1096},{"id":1137,"depth":242,"text":1138},{"id":1177,"depth":236,"text":1178,"children":1497},[1498,1499,1500],{"id":1181,"depth":242,"text":1182},{"id":1256,"depth":242,"text":1257},{"id":1275,"depth":242,"text":1276},{"id":1296,"depth":236,"text":1297,"children":1502},[1503,1504],{"id":1300,"depth":242,"text":1301},{"id":1368,"depth":242,"text":1369},{"id":1443,"depth":236,"text":1444},"Learn how to install, configure, and use Agent Skills in Profiles","md",null,{},{"title":61,"description":1506},"wVpahdesTgqi0uQ1jFGZQZ2ESQYGmr_7UCyfyuWRTu0",[1513,1515],{"title":57,"path":58,"stem":59,"description":1514,"children":-1},"How to register and manage ACP Agent Runtimes",{"title":65,"path":66,"stem":67,"description":1516,"children":-1},"Use the built-in VS Code for Workspace development",1778225993224]