[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M699C87RV5G675SSCEAH2K1N":3,"skill-same:01M699C87RV5G675SSCEAH2K1N":106},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":28,"publishedAt":51,"linkOnly":52,"markdownContent":53,"markdownBody":54,"frontMatter":55,"refName":56,"commitSha":57,"skillDirectory":58,"forksCount":59,"repositoryHtmlUrl":60,"repositoryHomepageUrl":61,"ownerHtmlUrl":62,"ownerBlogUrl":63,"ownerDescription":64,"updatedAt":65,"install":66,"resources":79},"01M699C87RV5G675SSCEAH2K1N","agent-customization",null,"**WORKFLOW SKILL** — Create, update, review, fix, or debug VS Code agent customization files (.instructions.md, .prompt.md, .agent.md, SKILL.md, copilot-instructions.md, AGENTS.md). USE FOR: saving coding preferences; troubleshooting why instructions\u002Fskills\u002Fagents are ignored or not invoked; configuring applyTo patterns; defining tool restrictions; creating custom agent modes or specialized workflows; packaging domain knowledge; fixing YAML frontmatter syntax. DO NOT USE FOR: general coding questions (use default agent); runtime debugging or error diagnosis; MCP server configuration (use MCP docs directly); VS Code extension development. INVOKES: file system tools (read\u002Fwrite customization files), ask-questions tool (interview user for requirements), subagents for codebase exploration. FOR SINGLE OPERATIONS: For quick YAML frontmatter fixes or creating a single file from a known pattern, edit the file directly — no skill needed.","microsoft\u002Fvscode","microsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F6154722?v=4","01M698VYDXZ6JW5WH3CRV650R8","Microsoft","01M6998NK2WED5M549DX06VBCH",195271,"MIT","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode\u002Fblob\u002Fmain\u002Fextensions\u002Fcopilot\u002Fassets\u002Fprompts\u002Fskills\u002Fagent-customization\u002FSKILL.md",[18,23],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":26,"taxonomyTypeDesc":27},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50],"agent customization","customization","codebase exploration","MCP","quick","error","workflow skill","false","exploration","default","files","packaging","fix","ask","knowledge","debugging","copilot","workflows","workflow","mcp server","docs","review","2026-11-10 10:12:30",false,"---\nname: agent-customization\nuser-invocable: false # don't show as slash command, we have sepcialized create-agent, create-instructions, create-hook prompts for that\ndescription: '**WORKFLOW SKILL** — Create, update, review, fix, or debug VS Code agent customization files (.instructions.md, .prompt.md, .agent.md, SKILL.md, copilot-instructions.md, AGENTS.md). USE FOR: saving coding preferences; troubleshooting why instructions\u002Fskills\u002Fagents are ignored or not invoked; configuring applyTo patterns; defining tool restrictions; creating custom agent modes or specialized workflows; packaging domain knowledge; fixing YAML frontmatter syntax. DO NOT USE FOR: general coding questions (use default agent); runtime debugging or error diagnosis; MCP server configuration (use MCP docs directly); VS Code extension development. INVOKES: file system tools (read\u002Fwrite customization files), ask-questions tool (interview user for requirements), subagents for codebase exploration. FOR SINGLE OPERATIONS: For quick YAML frontmatter fixes or creating a single file from a known pattern, edit the file directly — no skill needed.'\n---\n\n# Agent Customization\n\n## Decision Flow\n\n| Primitive | When to Use |\n|-----------|-------------|\n| agent instructions | Always-on, applies everywhere in the project |\n| File Instructions | Explicit via `applyTo` patterns, or on-demand via `description` |\n| MCP | Integrates external systems, APIs, or data |\n| Hooks | Deterministic shell commands at agent lifecycle points (block tools, auto-format, inject context) |\n| Custom Agents | Subagents for context isolation, or multi-stage workflows with tool restrictions |\n| Prompts | Single focused task with parameterized inputs |\n| Skills | On-demand workflow with bundled assets (scripts\u002Ftemplates) |\n\n## Quick Reference\n\nConsult the reference docs for templates, domain examples, advanced frontmatter options, asset organization, anti-patterns, and creation checklists. If the references are not enough, load the official documentation links for each primitive.\n\n| Type | File | Location | Reference |\n|------|------|----------|-----------|\n| agent instructions | `copilot-instructions.md`, `AGENTS.md` | `.github\u002F` or root | [Link](.\u002Freferences\u002Fagent-instructions.md) |\n| File Instructions | `*.instructions.md` | `.github\u002Finstructions\u002F` | [Link](.\u002Freferences\u002Finstructions.md) |\n| Prompts | `*.prompt.md` | `.github\u002Fprompts\u002F` | [Link](.\u002Freferences\u002Fprompts.md) |\n| Hooks | `*.json` | `.github\u002Fhooks\u002F` | [Link](.\u002Freferences\u002Fhooks.md) |\n| Custom Agents | `*.agent.md` | `.github\u002Fagents\u002F` | [Link](.\u002Freferences\u002Fagents.md) |\n| Skills | `SKILL.md` | `.github\u002Fskills\u002F\u003Cname>\u002F`, `.agents\u002Fskills\u002F\u003Cname>\u002F`, `.claude\u002Fskills\u002F\u003Cname>\u002F` | [Link](.\u002Freferences\u002Fskills.md) |\n\n**User-level**: `{{VSCODE_USER_PROMPTS_FOLDER}}\u002F` (*.prompt.md, *.instructions.md, *.agent.md; not skills)\nCustomizations roam with user's settings sync\n\n## Creation Process\n\nIf you need to explore or validate patterns in the codebase, use a read-only subagent. If the ask-questions tool is available, use it to interview the user and clarify requirements.\n\nFollow these steps when creating any customization file.\n\n### 1. Determine Scope\n\nAsk the user where they want the customization:\n- **Workspace**: For project-specific, team-shared customizations → `.github\u002F` folder\n- **User profile**: For personal, cross-workspace customizations → `{{VSCODE_USER_PROMPTS_FOLDER}}\u002F`\n\n### 2. Choose the Right Primitive\n\nUse the Decision Flow above to select the appropriate file type based on the user's need.\n\n### 3. Create the File\n\nCreate the file directly at the appropriate path:\n- Use the location tables in each reference file\n- Include required frontmatter as needed\n- Add the body content following the templates\n\n### 4. Validate\n\nAfter creating:\n- Confirm the file is in the correct location\n- Verify frontmatter syntax (YAML between `---` markers)\n- Check that `description` is present and meaningful\n\n## Edge Cases\n\n**Instructions vs Skill?** Does this apply to *most* work, or *specific* tasks? Most → Instructions. Specific → Skill.\n\n**Skill vs Prompt?** Both appear as slash commands in chat (type `\u002F`). Multi-step workflow with bundled assets → Skill. Single focused task with inputs → Prompt.\n\n**Skill vs Custom Agent?** Same capabilities for all steps → Skill. Need context isolation (subagent returns single output) or different tool restrictions per stage → Custom Agent.\n\n**Hooks vs Instructions?** Instructions *guide* agent behavior (non-deterministic). Hooks *enforce* behavior via shell commands at lifecycle events like `PreToolUse` or `PostToolUse` — they can block operations, require approval, or run formatters deterministically. Hooks can be defined in standalone `.json` files (see [hooks reference](.\u002Freferences\u002Fhooks.md)) or inline in custom agent frontmatter via the `hooks` attribute (see [agents reference](.\u002Freferences\u002Fagents.md)).\n\n## Common Pitfalls\n\n**Description is the discovery surface.** The `description` field is how the agent decides whether to load a skill, instruction, or agent. If trigger phrases aren't IN the description, the agent won't find it. Use the \"Use when...\" pattern with specific keywords.\n\n**YAML frontmatter silent failures.** Unescaped colons in values, tabs instead of spaces, `name` that doesn't match folder name — all cause silent failures with no error message. Always quote descriptions that contain colons: `description: \"Use when: doing X\"`.\n\n**`applyTo: \"**\"` burns context.** This means \"always included for every file request\" — it loads the instruction into the context window on every interaction, even when irrelevant. Use specific globs (`**\u002F*.py`, `src\u002Fapi\u002F**`) unless the instruction truly applies to all files.\n","# Agent Customization\n\n## Decision Flow\n\n| Primitive | When to Use |\n|-----------|-------------|\n| agent instructions | Always-on, applies everywhere in the project |\n| File Instructions | Explicit via `applyTo` patterns, or on-demand via `description` |\n| MCP | Integrates external systems, APIs, or data |\n| Hooks | Deterministic shell commands at agent lifecycle points (block tools, auto-format, inject context) |\n| Custom Agents | Subagents for context isolation, or multi-stage workflows with tool restrictions |\n| Prompts | Single focused task with parameterized inputs |\n| Skills | On-demand workflow with bundled assets (scripts\u002Ftemplates) |\n\n## Quick Reference\n\nConsult the reference docs for templates, domain examples, advanced frontmatter options, asset organization, anti-patterns, and creation checklists. If the references are not enough, load the official documentation links for each primitive.\n\n| Type | File | Location | Reference |\n|------|------|----------|-----------|\n| agent instructions | `copilot-instructions.md`, `AGENTS.md` | `.github\u002F` or root | [Link](.\u002Freferences\u002Fagent-instructions.md) |\n| File Instructions | `*.instructions.md` | `.github\u002Finstructions\u002F` | [Link](.\u002Freferences\u002Finstructions.md) |\n| Prompts | `*.prompt.md` | `.github\u002Fprompts\u002F` | [Link](.\u002Freferences\u002Fprompts.md) |\n| Hooks | `*.json` | `.github\u002Fhooks\u002F` | [Link](.\u002Freferences\u002Fhooks.md) |\n| Custom Agents | `*.agent.md` | `.github\u002Fagents\u002F` | [Link](.\u002Freferences\u002Fagents.md) |\n| Skills | `SKILL.md` | `.github\u002Fskills\u002F\u003Cname>\u002F`, `.agents\u002Fskills\u002F\u003Cname>\u002F`, `.claude\u002Fskills\u002F\u003Cname>\u002F` | [Link](.\u002Freferences\u002Fskills.md) |\n\n**User-level**: `{{VSCODE_USER_PROMPTS_FOLDER}}\u002F` (*.prompt.md, *.instructions.md, *.agent.md; not skills)\nCustomizations roam with user's settings sync\n\n## Creation Process\n\nIf you need to explore or validate patterns in the codebase, use a read-only subagent. If the ask-questions tool is available, use it to interview the user and clarify requirements.\n\nFollow these steps when creating any customization file.\n\n### 1. Determine Scope\n\nAsk the user where they want the customization:\n- **Workspace**: For project-specific, team-shared customizations → `.github\u002F` folder\n- **User profile**: For personal, cross-workspace customizations → `{{VSCODE_USER_PROMPTS_FOLDER}}\u002F`\n\n### 2. Choose the Right Primitive\n\nUse the Decision Flow above to select the appropriate file type based on the user's need.\n\n### 3. Create the File\n\nCreate the file directly at the appropriate path:\n- Use the location tables in each reference file\n- Include required frontmatter as needed\n- Add the body content following the templates\n\n### 4. Validate\n\nAfter creating:\n- Confirm the file is in the correct location\n- Verify frontmatter syntax (YAML between `---` markers)\n- Check that `description` is present and meaningful\n\n## Edge Cases\n\n**Instructions vs Skill?** Does this apply to *most* work, or *specific* tasks? Most → Instructions. Specific → Skill.\n\n**Skill vs Prompt?** Both appear as slash commands in chat (type `\u002F`). Multi-step workflow with bundled assets → Skill. Single focused task with inputs → Prompt.\n\n**Skill vs Custom Agent?** Same capabilities for all steps → Skill. Need context isolation (subagent returns single output) or different tool restrictions per stage → Custom Agent.\n\n**Hooks vs Instructions?** Instructions *guide* agent behavior (non-deterministic). Hooks *enforce* behavior via shell commands at lifecycle events like `PreToolUse` or `PostToolUse` — they can block operations, require approval, or run formatters deterministically. Hooks can be defined in standalone `.json` files (see [hooks reference](.\u002Freferences\u002Fhooks.md)) or inline in custom agent frontmatter via the `hooks` attribute (see [agents reference](.\u002Freferences\u002Fagents.md)).\n\n## Common Pitfalls\n\n**Description is the discovery surface.** The `description` field is how the agent decides whether to load a skill, instruction, or agent. If trigger phrases aren't IN the description, the agent won't find it. Use the \"Use when...\" pattern with specific keywords.\n\n**YAML frontmatter silent failures.** Unescaped colons in values, tabs instead of spaces, `name` that doesn't match folder name — all cause silent failures with no error message. Always quote descriptions that contain colons: `description: \"Use when: doing X\"`.\n\n**`applyTo: \"**\"` burns context.** This means \"always included for every file request\" — it loads the instruction into the context window on every interaction, even when irrelevant. Use specific globs (`**\u002F*.py`, `src\u002Fapi\u002F**`) unless the instruction truly applies to all files.\n",{"name":5,"description":7,"user-invocable":52},"main","11ba54a90a0ff8720cf47c086f5a9948eef9cf2c","extensions\u002Fcopilot\u002Fassets\u002Fprompts\u002Fskills\u002Fagent-customization",43773,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode","https:\u002F\u002Fcode.visualstudio.com","https:\u002F\u002Fgithub.com\u002Fmicrosoft","https:\u002F\u002Fopensource.microsoft.com","Open source projects and samples from Microsoft","2026-11-11 08:47:49",{"source":8,"skillName":5,"commands":67,"prompt":77,"zipAvailable":78},[68,71,74],{"tool":69,"command":70},"npx","npx skills add microsoft\u002Fvscode --skill agent-customization",{"tool":72,"command":73},"bunx","bunx skills add microsoft\u002Fvscode --skill agent-customization",{"tool":75,"command":76},"pnpm","pnpm dlx skills add microsoft\u002Fvscode --skill agent-customization","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode\u002Fblob\u002Fmain\u002Fextensions\u002Fcopilot\u002Fassets\u002Fprompts\u002Fskills\u002Fagent-customization\u002FSKILL.md",true,[80,86,90,94,98,102],{"path":81,"resourceType":82,"resourceTypeDesc":83,"sizeBytes":84,"sourceHtmlUrl":85},"references\u002Fagent-instructions.md","REFERENCE","参考文档",1948,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode\u002Fblob\u002Fmain\u002Fextensions\u002Fcopilot\u002Fassets\u002Fprompts\u002Fskills\u002Fagent-customization\u002Freferences\u002Fagent-instructions.md",{"path":87,"resourceType":82,"resourceTypeDesc":83,"sizeBytes":88,"sourceHtmlUrl":89},"references\u002Fagents.md",5143,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode\u002Fblob\u002Fmain\u002Fextensions\u002Fcopilot\u002Fassets\u002Fprompts\u002Fskills\u002Fagent-customization\u002Freferences\u002Fagents.md",{"path":91,"resourceType":82,"resourceTypeDesc":83,"sizeBytes":92,"sourceHtmlUrl":93},"references\u002Fhooks.md",2697,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode\u002Fblob\u002Fmain\u002Fextensions\u002Fcopilot\u002Fassets\u002Fprompts\u002Fskills\u002Fagent-customization\u002Freferences\u002Fhooks.md",{"path":95,"resourceType":82,"resourceTypeDesc":83,"sizeBytes":96,"sourceHtmlUrl":97},"references\u002Finstructions.md",2646,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode\u002Fblob\u002Fmain\u002Fextensions\u002Fcopilot\u002Fassets\u002Fprompts\u002Fskills\u002Fagent-customization\u002Freferences\u002Finstructions.md",{"path":99,"resourceType":82,"resourceTypeDesc":83,"sizeBytes":100,"sourceHtmlUrl":101},"references\u002Fprompts.md",2526,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode\u002Fblob\u002Fmain\u002Fextensions\u002Fcopilot\u002Fassets\u002Fprompts\u002Fskills\u002Fagent-customization\u002Freferences\u002Fprompts.md",{"path":103,"resourceType":82,"resourceTypeDesc":83,"sizeBytes":104,"sourceHtmlUrl":105},"references\u002Fskills.md",3027,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode\u002Fblob\u002Fmain\u002Fextensions\u002Fcopilot\u002Fassets\u002Fprompts\u002Fskills\u002Fagent-customization\u002Freferences\u002Fskills.md",[107,132,154,168,183,199],{"skillNo":108,"name":109,"nameZh":6,"description":110,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":111,"categories":112,"keywords":113,"publishedAt":51},"01M70H0ANBKZAVEP1NVV4K28M3","sweeper-query","Answer natural-language questions about the VS Code Sweeper's published issue index (index-\u003Cname>.json for microsoft\u002Fvscode and the enrolled family repos) — which issues are agent-ready to implement or plan, what the sweeper proposed for an assignee or area, whether the sweeper knows a report as a duplicate, the highest-value open bugs in a lane — and, for one issue, the review's full record (evidence with file citations, fix brief, proposed comment). Use ONLY when the request explicitly names the sweeper — \"sweeper\", \"vscodesweeper\", \"sweeper-query\", a sweeper verdict, record, brief or index, an agent-ready issue — or asks what \"the sweeper\" found, proposed or knows. Do NOT use for general questions about issues, duplicates, priorities or ranking that do not mention the sweeper. Read-only; discovery only.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fsweeper-query\u002FSKILL.md",[],[114,115,116,50,41,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131],"sweeper query","query","sweeper","when","request","which","natural-language","ranking","duplicates","ready","only","read","plan","open","Citations","brief","issues","code",{"skillNo":133,"name":134,"nameZh":6,"description":135,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":136,"categories":137,"keywords":138,"publishedAt":51},"01M699DRJS4YJCV600Q72SVVWE","update-skills","Create or update repository skills and instructions when major learnings are discovered during a session. Use when the user says \"learn!\", when a significant pattern or pitfall is identified, or when reusable domain knowledge should be captured for future sessions.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode\u002Fblob\u002Fmain\u002Fsrc\u002Fvs\u002Fsessions\u002Fskills\u002Fupdate-skills\u002FSKILL.md",[],[139,140,141,142,143,144,145,146,147,148,149,43,150,151,152,153,117],"update","update skills","for","pattern","domain","learnings","reusable","use","session","user","instructions","repository","learn","create","sessions",{"skillNo":155,"name":156,"nameZh":6,"description":157,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":158,"categories":159,"keywords":160,"publishedAt":51},"01M699DPWHZ72B66P82EW31RNE","update-pr","Update the pull request for the current session. Use when the user wants to push new changes to an existing PR.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode\u002Fblob\u002Fmain\u002Fsrc\u002Fvs\u002Fsessions\u002Fskills\u002Fupdate-pr\u002FSKILL.md",[],[139,161,162,117,118,163,141,146,147,148,164,165,166,167],"pr","update pr","Existing","push","pull","pull request","changes",{"skillNo":169,"name":170,"nameZh":6,"description":171,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":172,"categories":173,"keywords":174,"publishedAt":51},"01M699DJMR6CE1MH5XCJZ0GFQ0","sync","Sync the current session branch with its upstream branch, or publish the current session branch to a remote. Use when the user asks to sync a branch, pull latest changes, rebase onto upstream, push current branch, publish branch, or set upstream.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode\u002Fblob\u002Fmain\u002Fsrc\u002Fvs\u002Fsessions\u002Fskills\u002Fsync\u002FSKILL.md",[],[170,175,176,164,165,177,117,167,178,179,180,181,146,147,148,182],"SET","publish","rebase","latest","with","remote","upstream","branch",{"skillNo":184,"name":185,"nameZh":6,"description":186,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":187,"categories":188,"keywords":189,"publishedAt":51},"01M699DGXHX6A2A72X57R6GGHJ","sync-upstream","Update a stale session branch by rebasing onto the latest origin. Use when the upstream has moved significantly and the session needs to catch up, resolving conflicts by preserving upstream changes and adapting session work to fit.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode\u002Fblob\u002Fmain\u002Fsrc\u002Fvs\u002Fsessions\u002Fskills\u002Fsync-upstream\u002FSKILL.md",[],[181,170,190,191,117,192,193,167,178,194,195,196,197,146,147,182,198,139],"sync upstream","fit","catch","catch up","origin","conflicts","stale","up","work",{"skillNo":200,"name":201,"nameZh":6,"description":202,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":203,"categories":204,"keywords":205,"publishedAt":51},"01M699DEXYFWDGW0BAXJ5QQ377","merge","Merge changes from the topic branch to the merge base branch. Use when the user wants to merge their session's work back to the base branch.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode\u002Fblob\u002Fmain\u002Fsrc\u002Fvs\u002Fsessions\u002Fskills\u002Fmerge\u002FSKILL.md",[],[201,147,146,198,182,148,117,206,207,167],"back","base"]