Commit Graph
11 Commits
Author SHA1 Message Date
Chris McKee ae7bb2aa7c refactor: Simplify microsoft-docs skill to default-Learn-with-exceptions pattern, add Aspire MCP version gate 2026-02-08 20:27:08 -06:00
Chris McKee e765718787 refactor(aspire): flatten skill to references/, version-gate MCP tools, simplify integrations catalog
- Move all reference docs from cli/, mcp/, framework/ subfolders into references/ per agentskills.io spec

- Update all cross-references in SKILL.md and reference files

- Version-gate MCP tools: 9 tools in 13.1+, docs tools (list_docs/search_docs/get_doc) in 13.2+

- Simplify integrations-catalog.md to lead with MCP tool discovery (list_integrations/get_integration_docs)

- Remove .vscode/mcp.json (test artifact from aspire mcp init)
2026-02-08 19:53:48 -06:00
Chris McKee e4c35f3702 chore: rebuild README.skills.md without aspire skill (belongs to separate PR) 2026-02-06 10:36:51 -06:00
Chris McKee f28f8ab883 chore: Rebuild README.skills.md with updated description 2026-02-06 10:26:30 -06:00
Chris McKee b5cf6a2473 refactor: Remove Semantic Kernel library reference table 2026-02-06 10:13:28 -06:00
Chris McKee 00508b71f3 refactor: Remove Semantic Kernel prose, keep library reference table 2026-02-06 10:12:10 -06:00
Chris McKee bdaeff279f refactor: Replace DevUI tutorial content with research guidance
The skill is about how to research docs, not a DevUI tutorial. Replace the 10-step DevUI workflow checklist with a research strategy table showing which tool to use for each type of DevUI information.
2026-02-06 10:09:19 -06:00
Chris McKee ab8787b505 feat: Expand microsoft-docs skill with Agent Framework, DevUI, and Semantic Kernel coverage
Major improvements to the microsoft-docs skill:

- Add Microsoft Agent Framework section with two Context7 sources:
  /websites/learn_microsoft_en-us_agent-framework (tutorials, 2282 snippets)
  /microsoft/agent-framework (GitHub repo API detail, 1177 snippets)

- Add comprehensive DevUI workflow reference covering installation,
  programmatic launch, directory discovery, tracing, OpenAI-compatible
  API, OpenAI proxy, authentication, UI modes, .NET integration, and
  external observability export

- Add Semantic Kernel section with three quality-ranked sources covering
  Learn docs, agent framework subset, and GitHub repo

- Add guidance on when GitHub repo sources beat published docs (DevUI
  API reference, .NET integration, extension samples)

- Expand decision table with agent framework scenarios
- Add agent framework query examples for DevUI, SK, and workflows
- Highlight microsoft_code_sample_search with language filter for
  working code snippets

Tested all sources against identical queries to verify quality rankings.
2026-02-06 10:03:29 -06:00
Chris McKee 970cd25bef docs: Quality-rank Context7 libraries, flag deprecated docs-aspire repo
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
2026-02-06 09:41:19 -06:00
Chris McKee d41f11c83c docs: Prefer Context7 over GitHub search for Aspire doc lookups
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.
2026-02-06 09:37:45 -06:00
Chris McKee 6512c785c7 feat: Add Aspire polyglot distributed-app orchestration skill
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.
2026-02-05 19:00:02 -06:00