[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M699E71PG5ZK5VYPRFXWM8QH":3,"skill-same:01M699E71PG5ZK5VYPRFXWM8QH":52},{"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":18,"publishedAt":20,"linkOnly":21,"markdownContent":22,"markdownBody":23,"frontMatter":24,"refName":29,"commitSha":30,"skillDirectory":31,"forksCount":32,"repositoryHtmlUrl":33,"repositoryHomepageUrl":6,"ownerHtmlUrl":34,"ownerBlogUrl":35,"ownerDescription":36,"updatedAt":37,"install":38,"resources":51},"01M699E71PG5ZK5VYPRFXWM8QH","add-node",null,"Add or modify a node in an existing Copilot Studio topic. Use when the user asks to add a question, message, condition, variable, or other node to a topic. Do NOT use this for generative answers or knowledge search — use \u002Fadd-generative-answers instead.","microsoft\u002Fskills-for-copilot-studio","microsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F6154722?v=4","01M698VYDXZ6JW5WH3CRV650R8","Microsoft","01M699DXBD563FYBGWKPJJRAVM",493,"MIT","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills-for-copilot-studio\u002Fblob\u002Fmain\u002Fskills\u002Fadd-node\u002FSKILL.md",[],[19],"add node","2026-11-10 10:12:30",false,"---\nuser-invocable: false\ndescription: Add or modify a node in an existing Copilot Studio topic. Use when the user asks to add a question, message, condition, variable, or other node to a topic. Do NOT use this for generative answers or knowledge search — use \u002Fadd-generative-answers instead.\nargument-hint: \u003Cnode-type> to \u003Ctopic-name>\nallowed-tools: Bash(node *schema-lookup.bundle.js *), Read, Write, Edit, Glob\ncontext: fork\nagent: copilot-studio-author\n---\n\n# Add Node to Topic\n\nAdd a new node to an existing Copilot Studio topic, or modify an existing one.\n\nIn Copilot Studio, the elements inside a topic's `actions` array are **nodes** (SendActivity, Question, ConditionGroup, etc.). These are different from **actions** (`actions\u002F*.mcs.yml`), which are connector-based TaskDialogs. This skill handles nodes within topics.\n\n**For generative answers (SearchAndSummarizeContent, AnswerQuestionWithAI)**, use the `\u002Fadd-generative-answers` skill instead — it has the specific patterns, follow-up ConditionGroup logic, and disambiguation guidance needed to set them up correctly.\n\n## Instructions\n\n1. **Auto-discover the agent directory**:\n   ```\n   Glob: **\u002Fagent.mcs.yml\n   ```\n   NEVER hardcode an agent name.\n\n2. **Parse the arguments** to identify:\n   - The node type (SendActivity, Question, SetVariable, ConditionGroup, etc.)\n   - The target topic file\n   - If modifying an existing node, which node to modify\n\n3. **Look up the node schema**:\n   ```bash\n   node ${CLAUDE_SKILL_DIR}\u002F..\u002F..\u002Fscripts\u002Fschema-lookup.bundle.js resolve \u003CNodeType>\n   ```\n\n4. **Read the existing topic file** to understand its current structure.\n\n5. **Generate or modify the node** with:\n   - A unique ID (format: `\u003CnodeType>_\u003C6-8 random alphanumeric>`)\n   - All required properties from the schema\n   - Appropriate default values\n\n6. **Determine the correct insertion point** in the actions array and present the plan to the user before writing.\n\n## Common Node Types\n\n| Node | Purpose | Key Properties |\n|------|---------|----------------|\n| `SendActivity` | Send message | `kind`, `id`, `activity` |\n| `Question` | Ask user input | `kind`, `id`, `variable`, `prompt`, `entity` |\n| `SetVariable` | Set\u002Fcompute value | `kind`, `id`, `variable`, `value` |\n| `SetTextVariable` | Set text with interpolation (YAML-only, no canvas) | `kind`, `id`, `variable`, `value` |\n| `ConditionGroup` | Branching logic | `kind`, `id`, `conditions` |\n| `BeginDialog` | Call another topic | `kind`, `id`, `dialog` |\n| `EndDialog` | End topic | `kind`, `id` |\n| `CancelAllDialogs` | Cancel all topics | `kind`, `id` |\n\n## Generative Orchestration Guidelines\n\nWhen the agent has `GenerativeActionsEnabled: true`:\n\n- Prefer **AutomaticTaskInput** over Question nodes for collecting user info (the orchestrator handles prompting automatically).\n- Still use Question nodes when: conditional asks (ask X only if Y), or end-of-flow confirmations.\n- Prefer **topic outputs** over SendActivity for returning results.\n- Do NOT use SendActivity to show final outputs unless it's a precise mid-flow message.\n\n## Power Fx Quick Reference\n\n- Expressions start with `=`: `condition: =System.FallbackCount \u003C 3`\n- String interpolation uses `{}`: `activity: \"Error: {System.Error.Message}\"`\n- Variable init on first assignment: `variable: init:Topic.MyVar`\n- Common: `Text()`, `Now()`, `IsBlank()`, `!IsBlank()`\n\n## Example: Adding a Question Node\n\n```yaml\n- kind: Question\n  id: question_k7xPm2\n  variable: init:Topic.UserName\n  prompt: What is your name?\n  entity: StringPrebuiltEntity\n  alwaysPrompt: true\n  interruptionPolicy:\n    allowInterruption: false\n```\n\n## Important Notes\n\n- **Unique IDs**: Use random 6-8 alphanumeric characters. Duplicate IDs cause Copilot Studio errors.\n- Verify the node type exists in the schema before generating.\n- For ConditionGroup, include at least one condition item with its own unique ID.\n","# Add Node to Topic\n\nAdd a new node to an existing Copilot Studio topic, or modify an existing one.\n\nIn Copilot Studio, the elements inside a topic's `actions` array are **nodes** (SendActivity, Question, ConditionGroup, etc.). These are different from **actions** (`actions\u002F*.mcs.yml`), which are connector-based TaskDialogs. This skill handles nodes within topics.\n\n**For generative answers (SearchAndSummarizeContent, AnswerQuestionWithAI)**, use the `\u002Fadd-generative-answers` skill instead — it has the specific patterns, follow-up ConditionGroup logic, and disambiguation guidance needed to set them up correctly.\n\n## Instructions\n\n1. **Auto-discover the agent directory**:\n   ```\n   Glob: **\u002Fagent.mcs.yml\n   ```\n   NEVER hardcode an agent name.\n\n2. **Parse the arguments** to identify:\n   - The node type (SendActivity, Question, SetVariable, ConditionGroup, etc.)\n   - The target topic file\n   - If modifying an existing node, which node to modify\n\n3. **Look up the node schema**:\n   ```bash\n   node ${CLAUDE_SKILL_DIR}\u002F..\u002F..\u002Fscripts\u002Fschema-lookup.bundle.js resolve \u003CNodeType>\n   ```\n\n4. **Read the existing topic file** to understand its current structure.\n\n5. **Generate or modify the node** with:\n   - A unique ID (format: `\u003CnodeType>_\u003C6-8 random alphanumeric>`)\n   - All required properties from the schema\n   - Appropriate default values\n\n6. **Determine the correct insertion point** in the actions array and present the plan to the user before writing.\n\n## Common Node Types\n\n| Node | Purpose | Key Properties |\n|------|---------|----------------|\n| `SendActivity` | Send message | `kind`, `id`, `activity` |\n| `Question` | Ask user input | `kind`, `id`, `variable`, `prompt`, `entity` |\n| `SetVariable` | Set\u002Fcompute value | `kind`, `id`, `variable`, `value` |\n| `SetTextVariable` | Set text with interpolation (YAML-only, no canvas) | `kind`, `id`, `variable`, `value` |\n| `ConditionGroup` | Branching logic | `kind`, `id`, `conditions` |\n| `BeginDialog` | Call another topic | `kind`, `id`, `dialog` |\n| `EndDialog` | End topic | `kind`, `id` |\n| `CancelAllDialogs` | Cancel all topics | `kind`, `id` |\n\n## Generative Orchestration Guidelines\n\nWhen the agent has `GenerativeActionsEnabled: true`:\n\n- Prefer **AutomaticTaskInput** over Question nodes for collecting user info (the orchestrator handles prompting automatically).\n- Still use Question nodes when: conditional asks (ask X only if Y), or end-of-flow confirmations.\n- Prefer **topic outputs** over SendActivity for returning results.\n- Do NOT use SendActivity to show final outputs unless it's a precise mid-flow message.\n\n## Power Fx Quick Reference\n\n- Expressions start with `=`: `condition: =System.FallbackCount \u003C 3`\n- String interpolation uses `{}`: `activity: \"Error: {System.Error.Message}\"`\n- Variable init on first assignment: `variable: init:Topic.MyVar`\n- Common: `Text()`, `Now()`, `IsBlank()`, `!IsBlank()`\n\n## Example: Adding a Question Node\n\n```yaml\n- kind: Question\n  id: question_k7xPm2\n  variable: init:Topic.UserName\n  prompt: What is your name?\n  entity: StringPrebuiltEntity\n  alwaysPrompt: true\n  interruptionPolicy:\n    allowInterruption: false\n```\n\n## Important Notes\n\n- **Unique IDs**: Use random 6-8 alphanumeric characters. Duplicate IDs cause Copilot Studio errors.\n- Verify the node type exists in the schema before generating.\n- For ConditionGroup, include at least one condition item with its own unique ID.\n",{"agent":25,"context":26,"description":7,"allowed-tools":27,"argument-hint":28,"user-invocable":21},"copilot-studio-author","fork","Bash(node *schema-lookup.bundle.js *), Read, Write, Edit, Glob","\u003Cnode-type> to \u003Ctopic-name>","main","9c42d3a612c6e06389b6e5b4eed579aaed1a8b63","skills\u002Fadd-node",103,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills-for-copilot-studio","https:\u002F\u002Fgithub.com\u002Fmicrosoft","https:\u002F\u002Fopensource.microsoft.com","Open source projects and samples from Microsoft","2026-11-12 17:03:17",{"source":8,"skillName":5,"commands":39,"prompt":49,"zipAvailable":50},[40,43,46],{"tool":41,"command":42},"npx","npx skills add microsoft\u002Fskills-for-copilot-studio --skill add-node",{"tool":44,"command":45},"bunx","bunx skills add microsoft\u002Fskills-for-copilot-studio --skill add-node",{"tool":47,"command":48},"pnpm","pnpm dlx skills add microsoft\u002Fskills-for-copilot-studio --skill add-node","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills-for-copilot-studio\u002Fblob\u002Fmain\u002Fskills\u002Fadd-node\u002FSKILL.md",true,[],[53,65,83,92,103,112],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":64,"publishedAt":20},"01M699FD973RBVBTQYE48GBFPG","validate","Validate Copilot Studio agent YAML files using the LSP binary's full diagnostics (YAML structure, Power Fx, schema, cross-file references). Use when the user asks to check, validate, or verify YAML files.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills-for-copilot-studio\u002Fblob\u002Fmain\u002Fskills\u002Fvalidate\u002FSKILL.md",[59],{"categoryNo":60,"categoryName":61,"taxonomyType":62,"taxonomyTypeDesc":63},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[55],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":77,"publishedAt":20},"01M699FBJC22B4HCFH9MA844C3","test-auth","Authenticate for Copilot Studio evaluation API and SDK chat. Caches a token that is shared across run-eval and chat-sdk skills. Run this before any eval or SDK chat workflow. Requires an App Registration with MakerOperations and Copilots.Invoke permissions.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills-for-copilot-studio\u002Fblob\u002Fmain\u002Fskills\u002Ftest-auth\u002FSKILL.md",[71,74],{"categoryNo":72,"categoryName":73,"taxonomyType":62,"taxonomyTypeDesc":63},"01JBSEEDCAT000000000000008","测试与质量",{"categoryNo":75,"categoryName":76,"taxonomyType":62,"taxonomyTypeDesc":63},"01JBSEEDCAT000000000000010","后端与接口",[78,79,80,81,82],"test","auth","test auth","sdk","workflow",{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":90,"publishedAt":20},"01M699FA38G1TAVA0JWD9DG783","run-tests-kit","Run a batch test suite via the Copilot Studio Kit (Dataverse API). Uses the Power CAT Copilot Studio Kit to execute test cases against a published agent and produces pass\u002Ffail results with latencies. Requires the Kit installed in the environment, an App Registration with Dataverse permissions, and a published agent.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills-for-copilot-studio\u002Fblob\u002Fmain\u002Fskills\u002Frun-tests-kit\u002FSKILL.md",[89],{"categoryNo":72,"categoryName":73,"taxonomyType":62,"taxonomyTypeDesc":63},[91,78],"run tests kit",{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":101,"publishedAt":20},"01M699F8EP4BZT1EA3R4Y40X98","run-eval","Run evaluations against a Copilot Studio agent via the Power Platform Evaluation API. Works on DRAFT agents — no publish step required. Lists test sets, starts a run, polls until complete, fetches results, and proposes YAML fixes for failures. Use when the user wants to test agent changes without publishing.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills-for-copilot-studio\u002Fblob\u002Fmain\u002Fskills\u002Frun-eval\u002FSKILL.md",[98,99,100],{"categoryNo":72,"categoryName":73,"taxonomyType":62,"taxonomyTypeDesc":63},{"categoryNo":75,"categoryName":76,"taxonomyType":62,"taxonomyTypeDesc":63},{"categoryNo":60,"categoryName":61,"taxonomyType":62,"taxonomyTypeDesc":63},[102,78],"run eval",{"skillNo":104,"name":105,"nameZh":6,"description":106,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":107,"categories":108,"keywords":110,"publishedAt":20},"01M699F6NR5Z4RTN5MWH5WYV9H","new-topic","Create a new Copilot Studio topic YAML file. Use when the user asks to create a new topic, conversation flow, or dialog for their agent.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills-for-copilot-studio\u002Fblob\u002Fmain\u002Fskills\u002Fnew-topic\u002FSKILL.md",[109],{"categoryNo":60,"categoryName":61,"taxonomyType":62,"taxonomyTypeDesc":63},[111],"new topic",{"skillNo":113,"name":114,"nameZh":6,"description":115,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":116,"categories":117,"keywords":119,"publishedAt":20},"01M699F4QN5BMQA3X9F7WC1NS0","manage-agent","Push\u002Fpull Copilot Studio agent content via the VS Code extension's LanguageServerHost LSP binary. Handles authentication (interactive browser login for push\u002Fpull, device code flow for chat token), sync push, sync pull, clone, and diff operations.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills-for-copilot-studio\u002Fblob\u002Fmain\u002Fskills\u002Fmanage-agent\u002FSKILL.md",[118],{"categoryNo":60,"categoryName":61,"taxonomyType":62,"taxonomyTypeDesc":63},[120,79,121],"manage agent","sync"]