feat: Add Aspire polyglot distributed-app orchestration skill#669
Open
ChrisMcKee1 wants to merge 3 commits intogithub:mainfrom
Open
feat: Add Aspire polyglot distributed-app orchestration skill#669ChrisMcKee1 wants to merge 3 commits intogithub:mainfrom
ChrisMcKee1 wants to merge 3 commits intogithub:mainfrom
Conversation
Add comprehensive Aspire skill covering CLI, AppHost orchestration, service discovery, integrations (144+), MCP server, dashboard, testing, deployment, and troubleshooting. Includes reference docs for polyglot APIs, architecture, CLI, integrations catalog, and more.
Contributor
There was a problem hiding this comment.
Pull request overview
This PR adds a comprehensive Aspire skill covering .NET Aspire's polyglot distributed-application orchestration toolchain. The skill provides detailed documentation for creating, running, debugging, configuring, deploying, and troubleshooting Aspire distributed applications.
Changes:
- Added new
aspireskill with main SKILL.md and 9 reference documents covering all aspects of Aspire - Updated README.skills.md to include the new skill with all bundled assets listed
- All files follow proper naming conventions (lowercase with hyphens)
Reviewed changes
Copilot reviewed 11 out of 11 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| skills/aspire/SKILL.md | Main skill file with front matter, progressive disclosure structure, and references to all 9 documentation files |
| skills/aspire/references/architecture.md | Deep dive into DCP engine, resource model, service discovery, networking, and telemetry |
| skills/aspire/references/cli-reference.md | Complete CLI command reference with flags and usage examples |
| skills/aspire/references/dashboard.md | Dashboard features, standalone mode, and GenAI Visualizer documentation |
| skills/aspire/references/deployment.md | Deployment targets (Docker, Kubernetes, Azure) and CI/CD integration |
| skills/aspire/references/integrations-catalog.md | 144+ integrations across 13 categories with package references |
| skills/aspire/references/mcp-server.md | MCP server setup for AI assistants with configuration examples |
| skills/aspire/references/polyglot-apis.md | Complete API reference for 10+ languages including C#, Python, JavaScript, Go, Java, and Rust |
| skills/aspire/references/testing.md | Integration testing patterns with xUnit, MSTest, and NUnit examples |
| skills/aspire/references/troubleshooting.md | Diagnostic codes and common issues with solutions |
| docs/README.skills.md | Updated to include the aspire skill entry with all 9 bundled assets |
Rewrite Section 1 (Researching Aspire Documentation) to use Context7 as the primary method for querying docs and code examples. Context7 provides a single-step lookup with code snippets and source links, vs the two-step GitHub search + file read approach. The GitHub method is preserved as a fallback.
Tested all 5 Context7 Aspire library IDs with identical queries to compare content freshness and quality. Key findings: - /microsoft/aspire.dev (repo) has the best coverage including Aspire 13+ APIs - /websites/learn_microsoft-en-us-dotnet-aspire (website) is a good alternative - /dotnet/docs-aspire is the LEGACY repo being superseded, missing newer APIs - Added quality ranking table, usage guidance per source, and expanded query examples
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Adds a comprehensive Aspire skill to the
skills/directory, covering .NET Aspire's polyglot distributed-application orchestration toolchain.What's included
skills/aspire/SKILL.md— Main skill file with progressive disclosure structure covering:9 reference documents in
skills/aspire/references/:polyglot-apis.md— Full method signatures and chaining optionsintegrations-catalog.md— 144+ integrations across 13 categoriescli-reference.md— All CLI commands with flags and usagearchitecture.md— DCP internals, resource model, networking, telemetrydeployment.md— Docker, Kubernetes, Azure Container Apps, App Servicemcp-server.md— MCP server setup for AI assistantsdashboard.md— Dashboard features, standalone mode, GenAI Visualizertesting.md— Integration testing patternstroubleshooting.md— Diagnostic codes, common errors, fixesChecklist
SKILL.mdfilenamefield matches folder name (aspire, lowercase)descriptionfield is non-empty (253 chars, within 10-1024 range)npm run skill:validatepasses (all 38 skills valid)npm run buildexecuted (README.skills.md updated)