Separate azure-devops-cli SKILL.md into smaller files

[fondoger]

Pull Request Checklist

• I have read and followed the CONTRIBUTING.md guidelines.
• My contribution adds a new instruction, prompt, agent, skill, or workflow file in the correct directory.
• The file follows the required naming convention.
• The content is clearly structured and follows the example format.
• I have tested my instructions, prompt, agent, skill, or workflow with GitHub Copilot.
• I have run npm start and verified that README.md is up to date.

---

This skill modified based on the original azure-devops-cli skill. We separate the large SKILL.md into smaller files.

Structure

The original monolithic SKILL.md (2,466 lines) has been split into a compact main file with on-demand reference files to save tokens.

skills/azure-devops-cli/
├── SKILL.md                              (93 lines - basics + routing table)
└── references/
    ├── repos-and-prs.md                  (Repositories, PRs, Git refs, branch policies)
    ├── pipelines-and-builds.md           (Pipelines, runs, builds, releases, artifacts)
    ├── boards-and-iterations.md          (Work items, area paths, iterations)
    ├── variables-and-agents.md           (Pipeline variables, variable groups, agents)
    ├── org-and-security.md               (Projects, teams, users, permissions, wikis, admin)
    ├── advanced-usage.md                 (Output formats, JMESPath queries, global args)
    └── workflows-and-patterns.md         (Workflows, best practices, scripting patterns)

Only SKILL.md is loaded when the skill triggers. Reference files are read on demand based on the user's task.

Token Estimation

Estimated using ~1 token per 4 characters (English text approximation).

Scenario	Loaded content	~Tokens
Before (monolithic)	Full SKILL.md (55KB, 2,466 lines)	~14,000
After (always loaded)	Compact SKILL.md (3.9KB, 93 lines)	~1,000
After (typical task)	SKILL.md + 1 reference file	~2,500 - 4,500

Most tasks only need 1-2 reference files, saving 60-90% tokens compared to loading everything upfront.

---

Type of Contribution

• New instruction file.
• New prompt file.
• New agent file.
• New plugin.
• New skill file.
• New agentic workflow.
• Update to existing instruction, prompt, agent, plugin, skill, or workflow.
• Other (please specify):

---

By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.

[Copilot]

Pull request overview

Adds and restructures multiple plugin assets by introducing new agent/skill markdown files and simplifying plugin manifests to point at agent/skill directories instead of enumerating individual files.

Changes:

• Added several new agent definitions across multiple plugins (e.g., polyglot test agents, partners agents, MCP/dev tooling agents).
• Added multiple new skill SKILL.md files across plugins (e.g., OpenAPI-to-app skills per framework, Java/.NET/Dataverse skills).
• Updated many plugin.json manifests to reference ./agents folders (and normalized some ./skills/* paths by removing trailing slashes).

Reviewed changes

Copilot reviewed 143 out of 240 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
plugins/polyglot-test-agent/agents/polyglot-test-generator.md	New polyglot test generator agent definition.
plugins/polyglot-test-agent/agents/polyglot-test-fixer.md	New polyglot compilation-error fixer agent definition.
plugins/polyglot-test-agent/agents/polyglot-test-builder.md	New polyglot builder agent definition.
plugins/polyglot-test-agent/.github/plugin/plugin.json	Switches agent registration to ./agents and normalizes skills path.
plugins/php-mcp-development/.github/plugin/plugin.json	Switches agent registration to ./agents and normalizes skills path.
plugins/partners/agents/pagerduty-incident-responder.md	New PagerDuty incident responder agent definition.
plugins/partners/agents/octopus-deploy-release-notes-mcp.md	New Octopus Deploy release notes agent definition.
plugins/partners/agents/neon-optimization-analyzer.md	New Neon query optimization agent definition.
plugins/partners/agents/neon-migration-specialist.md	New Neon migration agent definition.
plugins/partners/agents/mongodb-performance-advisor.md	New MongoDB performance advisor agent definition.
plugins/partners/agents/lingodotdev-i18n.md	New Lingo.dev i18n agent definition.
plugins/partners/agents/jfrog-sec.md	New JFrog security agent definition.
plugins/partners/agents/elasticsearch-observability.md	New Elastic observability agent definition.
plugins/partners/agents/diffblue-cover.md	New Diffblue Cover unit test agent definition.
plugins/partners/agents/arm-migration.md	New Arm migration agent definition.
plugins/partners/agents/amplitude-experiment-implementation.md	New Amplitude experiment implementation agent definition.
plugins/partners/.github/plugin/plugin.json	Switches agent registration to ./agents.
plugins/ospo-sponsorship/.github/plugin/plugin.json	Normalizes skills path by removing trailing slash.
plugins/openapi-to-application-python-fastapi/skills/openapi-to-application-code/SKILL.md	New OpenAPI-to-application skill definition (FastAPI plugin).
plugins/openapi-to-application-python-fastapi/agents/openapi-to-application.md	New OpenAPI-to-application agent definition (FastAPI plugin).
plugins/openapi-to-application-python-fastapi/.github/plugin/plugin.json	Switches agent registration to ./agents and normalizes skills path.
plugins/openapi-to-application-nodejs-nestjs/skills/openapi-to-application-code/SKILL.md	New OpenAPI-to-application skill definition (NestJS plugin).
plugins/openapi-to-application-nodejs-nestjs/agents/openapi-to-application.md	New OpenAPI-to-application agent definition (NestJS plugin).
plugins/openapi-to-application-nodejs-nestjs/.github/plugin/plugin.json	Switches agent registration to ./agents and normalizes skills path.
plugins/openapi-to-application-java-spring-boot/skills/openapi-to-application-code/SKILL.md	New OpenAPI-to-application skill definition (Spring Boot plugin).
plugins/openapi-to-application-java-spring-boot/agents/openapi-to-application.md	New OpenAPI-to-application agent definition (Spring Boot plugin).
plugins/openapi-to-application-java-spring-boot/.github/plugin/plugin.json	Switches agent registration to ./agents and normalizes skills path.
plugins/openapi-to-application-go/skills/openapi-to-application-code/SKILL.md	New OpenAPI-to-application skill definition (Go plugin).
plugins/openapi-to-application-go/agents/openapi-to-application.md	New OpenAPI-to-application agent definition (Go plugin).
plugins/openapi-to-application-go/.github/plugin/plugin.json	Switches agent registration to ./agents and normalizes skills path.
plugins/openapi-to-application-csharp-dotnet/skills/openapi-to-application-code/SKILL.md	New OpenAPI-to-application skill definition (.NET plugin).
plugins/openapi-to-application-csharp-dotnet/agents/openapi-to-application.md	New OpenAPI-to-application agent definition (.NET plugin).
plugins/openapi-to-application-csharp-dotnet/.github/plugin/plugin.json	Switches agent registration to ./agents and normalizes skills path.
plugins/mcp-m365-copilot/agents/mcp-m365-agent-expert.md	New Microsoft 365 Copilot MCP expert agent definition.
plugins/mcp-m365-copilot/.github/plugin/plugin.json	Switches agent registration to ./agents and normalizes skills paths.
plugins/kotlin-mcp-development/agents/kotlin-mcp-expert.md	New Kotlin MCP development agent definition.
plugins/kotlin-mcp-development/.github/plugin/plugin.json	Switches agent registration to ./agents and normalizes skills path.
plugins/java-mcp-development/.github/plugin/plugin.json	Switches agent registration to ./agents and normalizes skills path.
plugins/java-development/skills/java-springboot/SKILL.md	New Java Spring Boot best-practices skill definition.
plugins/java-development/skills/java-junit/SKILL.md	New Java JUnit best-practices skill definition.
plugins/java-development/skills/java-docs/SKILL.md	New Java Javadoc best-practices skill definition.
plugins/java-development/skills/create-spring-boot-java-project/SKILL.md	New Spring Boot project scaffolding skill definition.
plugins/java-development/.github/plugin/plugin.json	Normalizes skill paths by removing trailing slashes.
plugins/go-mcp-development/agents/go-mcp-expert.md	New Go MCP development agent definition.
plugins/go-mcp-development/.github/plugin/plugin.json	Switches agent registration to ./agents and normalizes skills path.
plugins/gem-team/agents/gem-reviewer.md	New gem-team security reviewer agent definition.
plugins/gem-team/agents/gem-orchestrator.md	New gem-team orchestrator agent definition.
plugins/gem-team/agents/gem-implementer.md	New gem-team implementer agent definition.
plugins/gem-team/agents/gem-documentation-writer.md	New gem-team documentation writer agent definition.
plugins/gem-team/agents/gem-devops.md	New gem-team DevOps agent definition.
plugins/gem-team/agents/gem-browser-tester.md	New gem-team browser tester agent definition.
plugins/gem-team/.github/plugin/plugin.json	Switches agent registration to ./agents.
plugins/frontend-web-dev/skills/playwright-generate-test/SKILL.md	New Playwright test generation skill definition.
plugins/frontend-web-dev/skills/playwright-explore-website/SKILL.md	New Playwright website exploration skill definition.
plugins/frontend-web-dev/.github/plugin/plugin.json	Switches agent registration to ./agents and normalizes skill paths.
plugins/edge-ai-tasks/.github/plugin/plugin.json	Switches agent registration to ./agents.
plugins/devops-oncall/skills/multi-stage-dockerfile/SKILL.md	New multi-stage Dockerfile skill definition.
plugins/devops-oncall/agents/azure-principal-architect.md	New Azure principal architect agent definition (devops-oncall plugin).
plugins/devops-oncall/.github/plugin/plugin.json	Switches agent registration to ./agents and normalizes skill paths.
plugins/dataverse/.github/plugin/plugin.json	Normalizes skills path by removing trailing slash.
plugins/dataverse-sdk-for-python/skills/dataverse-python-usecase-builder/SKILL.md	New Dataverse Python use-case builder skill definition.
plugins/dataverse-sdk-for-python/skills/dataverse-python-quickstart/SKILL.md	New Dataverse Python quickstart skill definition.
plugins/dataverse-sdk-for-python/skills/dataverse-python-production-code/SKILL.md	New Dataverse Python production patterns skill definition.
plugins/dataverse-sdk-for-python/skills/dataverse-python-advanced-patterns/SKILL.md	New Dataverse Python advanced patterns skill definition.
plugins/dataverse-sdk-for-python/.github/plugin/plugin.json	Normalizes skill paths by removing trailing slashes.
plugins/database-data-management/agents/postgresql-dba.md	New PostgreSQL DBA agent definition.
plugins/database-data-management/agents/ms-sql-dba.md	New MS SQL DBA agent definition.
plugins/database-data-management/.github/plugin/plugin.json	Switches agent registration to ./agents and normalizes skill paths.
plugins/csharp-mcp-development/skills/csharp-mcp-server-generator/SKILL.md	New C# MCP server generator skill definition.
plugins/csharp-mcp-development/agents/csharp-mcp-expert.md	New C# MCP expert agent definition.
plugins/csharp-mcp-development/.github/plugin/plugin.json	Switches agent registration to ./agents and normalizes skill path.
plugins/csharp-dotnet-development/skills/dotnet-upgrade/SKILL.md	New .NET upgrade planning skill definition.
plugins/csharp-dotnet-development/skills/dotnet-best-practices/SKILL.md	New .NET/C# best-practices skill definition.
plugins/csharp-dotnet-development/skills/csharp-xunit/SKILL.md	New xUnit best-practices skill definition.
plugins/csharp-dotnet-development/skills/csharp-tunit/SKILL.md	New TUnit best-practices skill definition.
plugins/csharp-dotnet-development/skills/csharp-nunit/SKILL.md	New NUnit best-practices skill definition.
plugins/csharp-dotnet-development/skills/csharp-async/SKILL.md	New C# async best-practices skill definition.
plugins/csharp-dotnet-development/skills/aspnet-minimal-api-openapi/SKILL.md	New ASP.NET Minimal API + OpenAPI skill definition.
plugins/csharp-dotnet-development/agents/expert-dotnet-software-engineer.md	New .NET expert agent definition.
plugins/csharp-dotnet-development/.github/plugin/plugin.json	Switches agent registration to ./agents and normalizes skill paths.
plugins/copilot-sdk/.github/plugin/plugin.json	Normalizes skills path by removing trailing slash.
plugins/context-engineering/skills/what-context-needed/SKILL.md	New context-requesting skill definition.
plugins/context-engineering/skills/refactor-plan/SKILL.md	New multi-file refactor planning skill definition.
plugins/context-engineering/skills/context-map/SKILL.md	New codebase context map skill definition.
plugins/context-engineering/agents/context-architect.md	New context architect agent definition.
plugins/context-engineering/.github/plugin/plugin.json	Switches agent registration to ./agents and normalizes skill paths.
plugins/clojure-interactive-programming/skills/remember-interactive-programming/SKILL.md	New interactive programming reminder skill definition.
plugins/clojure-interactive-programming/agents/clojure-interactive-programming.md	New Clojure interactive programming agent definition.
plugins/clojure-interactive-programming/.github/plugin/plugin.json	Switches agent registration to ./agents and normalizes skill path.
plugins/cast-imaging/agents/cast-imaging-structural-quality-advisor.md	New CAST Imaging quality advisor agent definition.
plugins/cast-imaging/agents/cast-imaging-software-discovery.md	New CAST Imaging discovery agent definition.
plugins/cast-imaging/agents/cast-imaging-impact-analysis.md	New CAST Imaging impact analysis agent definition.
plugins/cast-imaging/.github/plugin/plugin.json	Switches agent registration to ./agents.
plugins/azure-cloud-development/agents/terraform-azure-planning.md	New Azure Terraform planning agent definition.
plugins/azure-cloud-development/agents/terraform-azure-implement.md	New Azure Terraform implementation agent definition.
plugins/azure-cloud-development/agents/azure-verified-modules-terraform.md	New AVM Terraform guidance agent definition.
plugins/azure-cloud-development/agents/azure-verified-modules-bicep.md	New AVM Bicep guidance agent definition.
plugins/azure-cloud-development/agents/azure-saas-architect.md	New Azure SaaS architect agent definition.
plugins/azure-cloud-development/agents/azure-principal-architect.md	New Azure principal architect agent definition (azure-cloud-development plugin).
plugins/azure-cloud-development/agents/azure-logic-apps-expert.md	New Azure Logic Apps expert agent definition.
plugins/azure-cloud-development/.github/plugin/plugin.json	Switches agent registration to ./agents and normalizes skill paths.
plugins/awesome-copilot/skills/suggest-awesome-github-copilot-skills/SKILL.md	New skill for suggesting upstream skills.
plugins/awesome-copilot/skills/suggest-awesome-github-copilot-prompts/SKILL.md	New skill for suggesting upstream prompts.
plugins/awesome-copilot/skills/suggest-awesome-github-copilot-instructions/SKILL.md	New skill for suggesting upstream instructions.
plugins/awesome-copilot/skills/suggest-awesome-github-copilot-agents/SKILL.md	New skill for suggesting upstream agents.
plugins/awesome-copilot/agents/meta-agentic-project-scaffold.md	New meta scaffolding agent definition.
plugins/awesome-copilot/.github/plugin/plugin.json	Switches agent registration to ./agents and normalizes skill paths.

[Copilot]

The manifest switches agents from an explicit list of agent files to a directory path (\"./agents\"). If the plugin loader expects file paths (as the previous manifest structure strongly implies), this will cause agents to no longer be discoverable. Prefer keeping an explicit list of agent markdown files, or (if directory expansion is intended) ensure the loader supports directories and add a validation/test that asserts agent discovery from directory entries.

Suggested change

	"./agents"
	"./agents/polyglot-test-agent.agent.md"

[Copilot]

Typo in agent instructions: 'release nots' should be 'release notes' to avoid confusion.

Suggested change

	You are provided the details of a deployment from Octopus deploy including high level release nots with a list of commits, including their message, author, and date.
	You are provided the details of a deployment from Octopus deploy including high level release notes with a list of commits, including their message, author, and date.

[Copilot]

New skill content is being added, but this PR does not include any corresponding update to the relevant docs/README.<type>.md index. Please add entries for newly introduced skills/agents so they’re discoverable (e.g., update the appropriate docs README that catalogs skills/agents/plugins in this repository).

[Copilot]

Same concern as other plugin manifests: agents now points to a directory (\"./agents\") instead of enumerating agent files. Without explicit evidence that directory entries are supported by the plugin manifest schema/loader, this is likely to break agent registration for the plugin. Either revert to explicit agent file paths, or update/add a manifest schema validation step (and tests) that asserts directory expansion works as intended.