Conversation
There was a problem hiding this comment.
Pull request overview
Adds the external microsoft-docs plugin listing, while also normalizing many existing plugin manifests and introducing a large set of new agent/skill content across multiple plugin packs.
Changes:
- Add
microsoft-docstoplugins/external.jsonand.github/plugin/marketplace.json. - Update many
plugins/*/.github/plugin/plugin.jsonfiles to reference agent/skill directories (and remove trailing slashes on skill paths). - Add new agents/skills/reference docs for multiple plugin packs (Azure, MCP SDKs, databases, Playwright, etc.).
Reviewed changes
Copilot reviewed 124 out of 294 changed files in this pull request and generated 10 comments.
Show a summary per file
| File | Description |
|---|---|
| plugins/mcp-m365-copilot/agents/mcp-m365-agent-expert.md | Adds an M365 Copilot MCP agent definition. |
| plugins/mcp-m365-copilot/.github/plugin/plugin.json | Changes agent/skill references to directory-based paths. |
| plugins/kotlin-mcp-development/agents/kotlin-mcp-expert.md | Adds a Kotlin MCP server expert agent. |
| plugins/kotlin-mcp-development/.github/plugin/plugin.json | Switches agents/skills references to directories. |
| plugins/java-mcp-development/.github/plugin/plugin.json | Switches agents/skills references to directories. |
| plugins/java-development/skills/java-springboot/SKILL.md | Adds Spring Boot best-practices skill content. |
| plugins/java-development/skills/java-junit/SKILL.md | Adds JUnit best-practices skill content. |
| plugins/java-development/skills/java-docs/SKILL.md | Adds Javadoc best-practices skill content. |
| plugins/java-development/skills/create-spring-boot-java-project/SKILL.md | Adds Spring Boot project scaffolding skill content. |
| plugins/java-development/.github/plugin/plugin.json | Normalizes skill path entries (no trailing slash). |
| plugins/go-mcp-development/agents/go-mcp-expert.md | Adds Go MCP server expert agent. |
| plugins/go-mcp-development/.github/plugin/plugin.json | Switches agents/skills references to directories. |
| plugins/gem-team/agents/gem-reviewer.md | Adds security reviewer agent definition. |
| plugins/gem-team/agents/gem-implementer.md | Adds implementer agent definition. |
| plugins/gem-team/agents/gem-documentation-writer.md | Adds documentation-writer agent definition. |
| plugins/gem-team/agents/gem-devops.md | Adds DevOps agent definition. |
| plugins/gem-team/agents/gem-browser-tester.md | Adds browser testing agent definition. |
| plugins/gem-team/.github/plugin/plugin.json | Switches agents reference to directory. |
| plugins/frontend-web-dev/skills/playwright-generate-test/SKILL.md | Adds Playwright test generation skill content. |
| plugins/frontend-web-dev/skills/playwright-explore-website/SKILL.md | Adds Playwright exploration skill content. |
| plugins/frontend-web-dev/agents/electron-angular-native.md | Adds Electron/Angular review-mode agent content. |
| plugins/frontend-web-dev/.github/plugin/plugin.json | Switches agents/skills references to directories. |
| plugins/flowstudio-power-automate/skills/flowstudio-power-automate-mcp/references/connection-references.md | Adds Power Automate connection references documentation. |
| plugins/flowstudio-power-automate/skills/flowstudio-power-automate-mcp/references/action-types.md | Adds action type reference documentation. |
| plugins/flowstudio-power-automate/skills/flowstudio-power-automate-mcp/references/MCP-BOOTSTRAP.md | Adds MCP bootstrap quick reference documentation. |
| plugins/flowstudio-power-automate/skills/flowstudio-power-automate-debug/references/debug-workflow.md | Adds debugging workflow reference. |
| plugins/flowstudio-power-automate/skills/flowstudio-power-automate-debug/references/common-errors.md | Adds common errors reference. |
| plugins/flowstudio-power-automate/skills/flowstudio-power-automate-build/references/trigger-types.md | Adds trigger templates reference. |
| plugins/flowstudio-power-automate/skills/flowstudio-power-automate-build/references/flow-schema.md | Adds flow schema documentation. |
| plugins/flowstudio-power-automate/skills/flowstudio-power-automate-build/references/build-patterns.md | Adds build pattern templates documentation. |
| plugins/flowstudio-power-automate/.github/plugin/plugin.json | Normalizes skill paths (no trailing slash). |
| plugins/external.json | Adds external registry entry for microsoft-docs. |
| plugins/edge-ai-tasks/.github/plugin/plugin.json | Switches agents reference to directory. |
| plugins/doublecheck/skills/doublecheck/assets/verification-report-template.md | Adds verification report template asset. |
| plugins/doublecheck/agents/doublecheck.md | Adds Doublecheck verification agent. |
| plugins/doublecheck/.github/plugin/plugin.json | Switches agents/skills references to directories. |
| plugins/devops-oncall/skills/multi-stage-dockerfile/SKILL.md | Adds multi-stage Dockerfile skill content. |
| plugins/devops-oncall/agents/azure-principal-architect.md | Adds Azure principal architect agent content. |
| plugins/devops-oncall/.github/plugin/plugin.json | Switches agents/skills references to directories. |
| plugins/dataverse-sdk-for-python/skills/dataverse-python-usecase-builder/SKILL.md | Adds Dataverse Python use case builder skill. |
| plugins/dataverse-sdk-for-python/skills/dataverse-python-quickstart/SKILL.md | Adds Dataverse Python quickstart skill. |
| plugins/dataverse-sdk-for-python/skills/dataverse-python-production-code/SKILL.md | Adds production code guidelines for Dataverse Python. |
| plugins/dataverse-sdk-for-python/skills/dataverse-python-advanced-patterns/SKILL.md | Adds advanced patterns for Dataverse Python skill. |
| plugins/dataverse-sdk-for-python/.github/plugin/plugin.json | Normalizes skill paths (no trailing slash). |
| plugins/database-data-management/skills/postgresql-code-review/SKILL.md | Adds PostgreSQL code review skill content. |
| plugins/database-data-management/agents/postgresql-dba.md | Adds PostgreSQL DBA agent content. |
| plugins/database-data-management/agents/ms-sql-dba.md | Adds MS SQL DBA agent content. |
| plugins/database-data-management/.github/plugin/plugin.json | Switches agents/skills references to directories. |
| plugins/csharp-mcp-development/skills/csharp-mcp-server-generator/SKILL.md | Adds C# MCP server generator skill content. |
| plugins/csharp-mcp-development/agents/csharp-mcp-expert.md | Adds C# MCP expert agent content. |
| plugins/csharp-mcp-development/.github/plugin/plugin.json | Switches agents/skills references to directories. |
| plugins/csharp-dotnet-development/skills/dotnet-upgrade/SKILL.md | Adds .NET upgrade prompts/skill content. |
| plugins/csharp-dotnet-development/skills/dotnet-best-practices/SKILL.md | Adds .NET best practices skill content. |
| plugins/csharp-dotnet-development/skills/csharp-xunit/SKILL.md | Adds xUnit best practices skill content. |
| plugins/csharp-dotnet-development/skills/csharp-tunit/SKILL.md | Adds TUnit best practices skill content. |
| plugins/csharp-dotnet-development/skills/csharp-nunit/SKILL.md | Adds NUnit best practices skill content. |
| plugins/csharp-dotnet-development/skills/csharp-async/SKILL.md | Adds async best practices skill content. |
| plugins/csharp-dotnet-development/skills/aspnet-minimal-api-openapi/SKILL.md | Adds minimal API + OpenAPI skill content. |
| plugins/csharp-dotnet-development/agents/expert-dotnet-software-engineer.md | Adds .NET expert agent content. |
| plugins/csharp-dotnet-development/.github/plugin/plugin.json | Switches agents/skills references to directories. |
| plugins/copilot-sdk/.github/plugin/plugin.json | Normalizes skill path (no trailing slash). |
| plugins/context-engineering/skills/what-context-needed/SKILL.md | Adds context-needed skill content. |
| plugins/context-engineering/skills/refactor-plan/SKILL.md | Adds refactor plan skill content. |
| plugins/context-engineering/skills/context-map/SKILL.md | Adds context map skill content. |
| plugins/context-engineering/agents/context-architect.md | Adds context architect agent content. |
| plugins/context-engineering/.github/plugin/plugin.json | Switches agents/skills references to directories. |
| plugins/clojure-interactive-programming/skills/remember-interactive-programming/SKILL.md | Adds interactive programming reminder skill. |
| plugins/clojure-interactive-programming/agents/clojure-interactive-programming.md | Adds Clojure interactive programming agent. |
| plugins/clojure-interactive-programming/.github/plugin/plugin.json | Switches agents/skills references to directories. |
| plugins/cast-imaging/agents/cast-imaging-structural-quality-advisor.md | Adds CAST Imaging quality advisor agent. |
| plugins/cast-imaging/agents/cast-imaging-software-discovery.md | Adds CAST Imaging discovery agent. |
| plugins/cast-imaging/agents/cast-imaging-impact-analysis.md | Adds CAST Imaging impact analysis agent. |
| plugins/cast-imaging/.github/plugin/plugin.json | Switches agents reference to directory. |
| plugins/azure-cloud-development/skills/azure-pricing/references/SERVICE-NAMES.md | Adds Azure pricing service names reference. |
| plugins/azure-cloud-development/skills/azure-pricing/references/REGIONS.md | Adds Azure pricing regions reference. |
| plugins/azure-cloud-development/skills/azure-pricing/references/COST-ESTIMATOR.md | Adds Azure pricing cost estimator reference. |
| plugins/azure-cloud-development/skills/azure-pricing/references/COPILOT-STUDIO-RATES.md | Adds Copilot Studio rate reference. |
| plugins/azure-cloud-development/agents/terraform-azure-planning.md | Adds Terraform planning agent content. |
| plugins/azure-cloud-development/agents/terraform-azure-implement.md | Adds Terraform implementation agent content. |
| plugins/azure-cloud-development/agents/azure-verified-modules-terraform.md | Adds AVM Terraform agent content. |
| plugins/azure-cloud-development/agents/azure-verified-modules-bicep.md | Adds AVM Bicep agent content. |
| plugins/azure-cloud-development/agents/azure-saas-architect.md | Adds Azure SaaS architect agent content. |
| plugins/azure-cloud-development/agents/azure-principal-architect.md | Adds Azure principal architect agent content. |
| plugins/azure-cloud-development/agents/azure-logic-apps-expert.md | Adds Logic Apps expert agent content. |
| plugins/azure-cloud-development/.github/plugin/plugin.json | Switches agents/skills references to directories. |
| plugins/awesome-copilot/skills/suggest-awesome-github-copilot-skills/SKILL.md | Adds skill suggester skill. |
| plugins/awesome-copilot/skills/suggest-awesome-github-copilot-instructions/SKILL.md | Adds instructions suggester skill. |
| plugins/awesome-copilot/skills/suggest-awesome-github-copilot-agents/SKILL.md | Adds agents suggester skill. |
| plugins/awesome-copilot/agents/meta-agentic-project-scaffold.md | Adds meta scaffold agent content. |
| plugins/awesome-copilot/.github/plugin/plugin.json | Switches agents/skills references to directories. |
| plugins/automate-this/.github/plugin/plugin.json | Normalizes skill path (no trailing slash). |
| .github/plugin/marketplace.json | Adds marketplace entry for microsoft-docs. |
| { | ||
| "name": "microsoft-docs", | ||
| "description": "Access official Microsoft documentation, API references, and code samples for Azure, .NET, Windows, and more.", | ||
| "version": "1.0.0", |
There was a problem hiding this comment.
The PR description says this change adds the microsoft-docs plugin, but this PR also includes a broad sweep of unrelated additions and manifest changes across many plugin packs (new agents/skills and plugin.json path semantics). Please either (mandatory) update the PR description/title to reflect the expanded scope, or split the manifest refactor + content additions into separate PR(s) to keep review and rollback manageable.
| "agents": [ | ||
| "./agents/java-mcp-expert.md" | ||
| "./agents" | ||
| ], | ||
| "skills": [ | ||
| "./skills/java-mcp-server-generator/" | ||
| "./skills/java-mcp-server-generator" | ||
| ] |
There was a problem hiding this comment.
Several plugin manifests were changed from explicit agent file paths to a directory path (e.g., \"./agents\"). If the plugin loader expects a list of files (as the previous manifest implied), this will break discovery/indexing at runtime. (Mandatory) Confirm the registry/parser supports directory expansion; if not, revert to explicit file entries, or update the loader and add a validation step to ensure it resolves agent/skill files deterministically.
| --- | ||
| description: "Act as implementation planner for your Azure Terraform Infrastructure as Code task." | ||
| name: "Azure Terraform Infrastructure Planning" | ||
| tools: ["edit/editFiles", "fetch", "todos", "azureterraformbestpractices", "cloudarchitect", "documentation", "get_bestpractices", "microsoft-docs"] |
There was a problem hiding this comment.
Tool naming is inconsistent with other agent files in this PR that reference microsoft.docs.mcp. If the actual tool name is microsoft.docs.mcp (or another canonical name), using microsoft-docs / #microsoft-docs will cause tool invocation failures. (Mandatory) Standardize on the correct tool identifier across agents and within the instructions text so users can actually run the documented workflow.
| - **Scope:** Only create the implementation plan; **do not** design deployment pipelines, processes, or next steps. | ||
| - **Write-scope guardrail:** Only create or modify files under `.terraform-planning-files/` using `#editFiles`. Do **not** change other workspace files. If the folder `.terraform-planning-files/` does not exist, create it. | ||
| - Ensure the plan is comprehensive and covers all aspects of the Azure resources to be created | ||
| - You ground the plan using the latest information available from Microsoft Docs use the tool `#microsoft-docs` |
There was a problem hiding this comment.
Tool naming is inconsistent with other agent files in this PR that reference microsoft.docs.mcp. If the actual tool name is microsoft.docs.mcp (or another canonical name), using microsoft-docs / #microsoft-docs will cause tool invocation failures. (Mandatory) Standardize on the correct tool identifier across agents and within the instructions text so users can actually run the documented workflow.
| ## Focus areas | ||
|
|
||
| - Provide a detailed list of Azure resources with configurations, dependencies, parameters, and outputs. | ||
| - **Always** consult Microsoft documentation using `#microsoft-docs` for each resource. |
There was a problem hiding this comment.
Tool naming is inconsistent with other agent files in this PR that reference microsoft.docs.mcp. If the actual tool name is microsoft.docs.mcp (or another canonical name), using microsoft-docs / #microsoft-docs will cause tool invocation failures. (Mandatory) Standardize on the correct tool identifier across agents and within the instructions text so users can actually run the documented workflow.
| - Docker | ||
| - Docker Compose | ||
|
|
||
| - If you need to custom the project name, please change the `artifactId` and the `packageName` in [download-spring-boot-project-template](./create-spring-boot-java-project.prompt.md#download-spring-boot-project-template) |
There was a problem hiding this comment.
Two concrete issues in the setup instructions: (1) postgresql:17 is not the standard Docker image name; it should be postgres:17 (otherwise users will get an image pull error). (2) 'If you need to custom the project name' is grammatically incorrect; it should be 'customize'. Please correct both to avoid broken copy/paste flows.
| - If you need to custom the project name, please change the `artifactId` and the `packageName` in [download-spring-boot-project-template](./create-spring-boot-java-project.prompt.md#download-spring-boot-project-template) | |
| - If you need to customize the project name, please change the `artifactId` and the `packageName` in [download-spring-boot-project-template](./create-spring-boot-java-project.prompt.md#download-spring-boot-project-template) |
|
|
||
| ## Add `docker-compose.yaml` with Redis, PostgreSQL and MongoDB services | ||
|
|
||
| - Create `docker-compose.yaml` at project root and add following services: `redis:6`, `postgresql:17` and `mongo:8`. |
There was a problem hiding this comment.
Two concrete issues in the setup instructions: (1) postgresql:17 is not the standard Docker image name; it should be postgres:17 (otherwise users will get an image pull error). (2) 'If you need to custom the project name' is grammatically incorrect; it should be 'customize'. Please correct both to avoid broken copy/paste flows.
| # Redis configurations | ||
| spring.data.redis.host=localhost | ||
| spring.data.redis.port=6379 | ||
| spring.data.redis.password=rootroot |
There was a problem hiding this comment.
The skill currently hardcodes weak, reusable passwords (rootroot) in configuration examples. Even in docs, this tends to get copy/pasted into real projects. (Mandatory) Replace these with clearly-marked placeholders (e.g., ${REDIS_PASSWORD}) and/or explicitly instruct users to source secrets from environment variables / a local .env file, and note that credentials should never be committed.
| spring.datasource.username=postgres | ||
| spring.datasource.password=rootroot |
There was a problem hiding this comment.
The skill currently hardcodes weak, reusable passwords (rootroot) in configuration examples. Even in docs, this tends to get copy/pasted into real projects. (Mandatory) Replace these with clearly-marked placeholders (e.g., ${REDIS_PASSWORD}) and/or explicitly instruct users to source secrets from environment variables / a local .env file, and note that credentials should never be committed.
| spring.data.mongodb.username=root | ||
| spring.data.mongodb.password=rootroot |
There was a problem hiding this comment.
The skill currently hardcodes weak, reusable passwords (rootroot) in configuration examples. Even in docs, this tends to get copy/pasted into real projects. (Mandatory) Replace these with clearly-marked placeholders (e.g., ${REDIS_PASSWORD}) and/or explicitly instruct users to source secrets from environment variables / a local .env file, and note that credentials should never be committed.
Pull Request Checklist
npm startand verified thatREADME.mdis up to date.stagedbranch for this pull request.Description
This PR adds the microsoft-docs plugin, which is already in Claude Code official plugin store.
Type of Contribution
By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.