Microsoft Code Reference
MicrosoftDocs/mcp
Find working code samples, verify API signatures, and fix Microsoft SDK errors using official docs.
Use only when the user explicitly requests a deep Aspire architectural or pattern review of an existing PR or diff, or when a generic reviewer escalates a named Aspire-domain question it cannot…
$ npx skills add microsoft/aspire --skill reviewing-aspire-architecture -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install microsoft/aspire reviewing-aspire-architecture --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/microsoft/aspire.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/reviewing-aspire-architecture .claude/skills/reviewing-aspire-architecture && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "reviewing-aspire-architecture" agent skill from https://github.com/microsoft/aspire/tree/main/.agents/skills/reviewing-aspire-architecture into .claude/skills/reviewing-aspire-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reviewing-aspire-architecture", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/microsoft/aspire/tree/main/.agents/skills/reviewing-aspire-architectureType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add microsoft/aspire --skill reviewing-aspire-architecture -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install microsoft/aspire reviewing-aspire-architecture --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/microsoft/aspire.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/reviewing-aspire-architecture .agents/skills/reviewing-aspire-architecture && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "reviewing-aspire-architecture" agent skill from https://github.com/microsoft/aspire/tree/main/.agents/skills/reviewing-aspire-architecture into .agents/skills/reviewing-aspire-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reviewing-aspire-architecture", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add microsoft/aspire --skill reviewing-aspire-architecture -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install microsoft/aspire reviewing-aspire-architecture --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/microsoft/aspire.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/reviewing-aspire-architecture .cursor/skills/reviewing-aspire-architecture && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "reviewing-aspire-architecture" agent skill from https://github.com/microsoft/aspire/tree/main/.agents/skills/reviewing-aspire-architecture into .cursor/skills/reviewing-aspire-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reviewing-aspire-architecture", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/microsoft/aspire.git --path .agents/skills/reviewing-aspire-architecture--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add microsoft/aspire --skill reviewing-aspire-architecture -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install microsoft/aspire reviewing-aspire-architecture --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/microsoft/aspire.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/reviewing-aspire-architecture .gemini/skills/reviewing-aspire-architecture && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "reviewing-aspire-architecture" agent skill from https://github.com/microsoft/aspire/tree/main/.agents/skills/reviewing-aspire-architecture into .gemini/skills/reviewing-aspire-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reviewing-aspire-architecture", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install microsoft/aspire reviewing-aspire-architectureInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add microsoft/aspire --skill reviewing-aspire-architecture -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/microsoft/aspire.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/reviewing-aspire-architecture .github/skills/reviewing-aspire-architecture && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "reviewing-aspire-architecture" agent skill from https://github.com/microsoft/aspire/tree/main/.agents/skills/reviewing-aspire-architecture into .github/skills/reviewing-aspire-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reviewing-aspire-architecture", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add microsoft/aspire --skill reviewing-aspire-architecture -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install microsoft/aspire reviewing-aspire-architecture --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/microsoft/aspire.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/reviewing-aspire-architecture .opencode/skills/reviewing-aspire-architecture && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "reviewing-aspire-architecture" agent skill from https://github.com/microsoft/aspire/tree/main/.agents/skills/reviewing-aspire-architecture into .opencode/skills/reviewing-aspire-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reviewing-aspire-architecture", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
reviewing-aspire-architectureUse only when the user explicitly requests a deep Aspire architectural or pattern review of an existing PR or diff, or when a generic reviewer escalates a named Aspire-domain question it cannot…
Reviewing Aspire Architecture is an agent skill from microsoft/aspire, published by the product's own GitHub organization. Use only when the user explicitly requests a deep Aspire architectural or pattern review of an existing PR or diff, or when a generic reviewer escalates a named Aspire-domain question it cannot resolve. Do not use for ordinary review, implementation, debugging, explanation, or design discussion—even when a PR is referenced—and never select it from changed file paths alone.
Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Development. It works with Microsoft Azure. The repository describes itself as: Aspire is the tool for code-first, extensible, observable dev and deploy. The licence is MIT.
Read from SKILL.md and the folder at commit a1f8cbd. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Reviewing Aspire Architecture loads about 1.3k tokens when it runs. Until then it costs about 101 tokens; SKILL.md has 647 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from microsoft/aspire at commit a1f8cbd, republished under its MIT licence (© microsoft). 647 words, ~1,338 tokens.
.claude/skills/reviewing-aspire-architecture/SKILL.md (or your agent's skills folder).Aspire-specific architectural review via the reviewing-aspire-architecture agent. Catches domain patterns that generic code-review cannot.
Use only when at least one of these conditions is true:
Changed file location is routing information after this skill is selected, not a reason to select it. A PR touching hosting core, Azure integrations, dashboard, CLI, components, resource types, the app model, or deployment behavior does not by itself qualify.
Outside the post-review escalation path, the user's primary requested action must be architectural review. Asking to understand, explain, compare, or design something does not qualify, even when the request references a PR or diff.
Don't use this skill for implementation, debugging, testing, routine code changes, post-change validation, design questions or brainstorming, explanatory investigation, generic PR review, CI failures, flaky tests, or API surface review. Use code-review, ci-test-failures, fix-flaky-test, or api-review where appropriate.
For ordinary review routing, use code-review for doc/config-only PRs. This does not prevent a direct invocation when the user explicitly requests a deep architectural or pattern review of such a diff.
reviewing-aspire-architecture agent for a user review request and change-set revision.reviewing-aspire-architecture, do not invoke this skill or launch another reviewing-aspire-architecture agent.code-review covers generic bugs, security, perf, concurrency, and error handling and is sufficient for ordinary PR reviews. This skill covers only checks requiring Aspire domain knowledge. Some topic areas (Security, Performance, Error Handling) exist in both, but the checks are disjoint: generic patterns belong to code-review, Aspire-specific patterns belong here.
When the user explicitly requests a deep architectural or pattern review, invoke this skill directly; a preliminary code-review pass is not required.
For an ordinary review, always complete code-review before considering an organic escalation to this skill. Do not front-load the architectural review or use it to decide what the generic reviewer should inspect. After the generic findings are complete, escalate when correctness depends on a named Aspire-domain contract that the generic review cannot resolve from its own rules and evidence.
If code-review can already state a concrete, high-confidence defect, report it directly rather than escalating it. If escalation is justified, preserve the completed generic findings, run one focused architectural analysis, and merge only its net-new high-confidence findings. Do not rerun code-review afterward.
For an explicit full architectural review, inspect the PR context and only the dimensions selected by the changed-file routing below. For an escalation from another review, inspect only the supplied question, relevant diff, surrounding code, and existing comments needed to avoid duplication. Do not expand a focused escalation into a full PR review or repository-wide inventory.
| Folder | Dimensions |
|---|---|
src/Aspire.Hosting/** | Resource Model, API Design, Pattern Conformance, Containers |
src/Aspire.Hosting.Azure*/** | Azure Provisioning, Resource Model, API Design, Security |
src/Aspire.Dashboard/** | Dashboard UI/UX, Security, Performance |
src/Aspire.Cli/** | CLI Behavior, Error Handling, Platform Compatibility |
src/Components/** | Pattern Conformance, API Design, Build & Contributor Workflow |
tests/** | Test Quality + mirror dimensions of code under test |
eng/**, .github/** | Build & Contributor Workflow, Documentation & Naming |
Full review rules in the reviewing-aspire-architecture agent.
© microsoft, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in .agents/skills/reviewing-aspire-architecture of microsoft/aspire.
Open the folder on GitHubat commit a1f8cbd
Reviewing Aspire Architecture next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Reviewing Aspire Architecture this skillmicrosoft/aspire | 6.4k | — | ~1.3k | Automated safety check: Pass | MIT | |
| Microsoft Code ReferenceMicrosoftDocs/mcp | 1.9k | 3 repos | ~1.1k | Automated safety check: Pass | CC-BY-4.0 | |
| Version ReleaseNG-ZORRO/ng-zorro-antd | 9.2k | — | ~3.1k | Automated safety check: Pass | MIT | |
| DeepChat Provider IntegrationThinkInAIXYZ/deepchat | 6.4k | — | ~1.2k | Automated safety check: Pass | Apache-2.0 | |
| Code ReviewAzure/Azurite | 2.3k | — | ~734 | Automated safety check: Pass | MIT | |
| Add ModelPipelex/pipelex | 942 | — | ~2.8k | Automated safety check: Pass | Custom licence |
MicrosoftDocs/mcp
Find working code samples, verify API signatures, and fix Microsoft SDK errors using official docs.
NG-ZORRO/ng-zorro-antd
NG-ZORRO/ng-zorro-antd repository release workflow. An agent skill from NG-ZORRO/ng-zorro-antd.
ThinkInAIXYZ/deepchat
Guides adding an LLM provider to DeepChat through explicit source changes: collect the provider details, pick a transport path and add registry entries and tests.
Azure/Azurite
Review Azurite pull requests with service-aware checks for Blob, Queue, and Table behavior, API compatibility, tests, and release notes.
Pipelex/pipelex
Add a new AI model to Pipelex's own inference configuration: the backend TOMLs in .pipelex/inference/backends/ (OpenAI, Azure, Anthropic, Bedrock, Google, Vertex, Mistral and the rest), the kit…
Azure/AppConfiguration
Writes customer-facing release notes for Azure App Configuration libraries and providers in a fixed file layout, version heading and category structure.
microsoft/aspire
A skill your agent uses when asked to trigger or inspect Aspire internal Azure DevOps builds, source-index runs, or release validation on dnceng/internal; push to the internal mirror; download build…
microsoft/aspire
Backports a merged PR to a release branch by triggering the /backport bot, waiting for the bot-created PR, and filling in the shiproom template (Customer Impact, Testing, Risk, Regression?).
microsoft/aspire
Bumps the Aspire repository product version in eng/Versions.props using previous version-bump commits as guidance.
microsoft/aspire
Guide for diagnosing GitHub Actions test failures, extracting failed tests from runs, and creating or updating failing-test issues.
microsoft/aspire
Create a pull request using the repository PR template. An agent skill from microsoft/aspire.
microsoft/aspire
Guide for writing tests for the Aspire Dashboard. An agent skill from microsoft/aspire.
Works with
Categories
Use only when the user explicitly requests a deep Aspire architectural or pattern review of an existing PR or diff, or when a generic reviewer escalates a named Aspire-domain question it cannot…. Reviewing Aspire Architecture is an agent skill from microsoft/aspire, published by the product's own GitHub organization. Use only when the user explicitly requests a deep Aspire architectural or pattern review of an existing PR or diff, or when a generic reviewer escalates a named Aspire-domain question it cannot resolve.
Reviewing Aspire Architecture fits situations like: explicitly requests a deep Aspire architectural; pattern review of an existing PR; A generic reviewer escalates a named Aspire-domain question it cannot resolve; ordinary review.
Run `npx skills add microsoft/aspire --skill reviewing-aspire-architecture -a claude-code`. Or copy the skill folder (.agents/skills/reviewing-aspire-architecture in microsoft/aspire) into .claude/skills/reviewing-aspire-architecture in your project. Claude Code loads it when a task matches its description.
Run `npx skills add microsoft/aspire --skill reviewing-aspire-architecture -a codex`. Or copy the skill folder (.agents/skills/reviewing-aspire-architecture in microsoft/aspire) into .agents/skills/reviewing-aspire-architecture in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add microsoft/aspire --skill reviewing-aspire-architecture -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/reviewing-aspire-architecture, .gemini/skills/reviewing-aspire-architecture, .github/skills/reviewing-aspire-architecture and .opencode/skills/reviewing-aspire-architecture in your project.
SKILL.md names no scripts, command-line tools or credentials: Reviewing Aspire Architecture is instructions for the agent only.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Reviewing Aspire Architecture is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.3k tokens (SKILL.md is roughly 5.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Reviewing Aspire Architecture: Microsoft Code Reference (MicrosoftDocs/mcp, 1.9k stars), Version Release (NG-ZORRO/ng-zorro-antd, 9.2k stars), DeepChat Provider Integration (ThinkInAIXYZ/deepchat, 6.4k stars) and Code Review (Azure/Azurite, 2.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
microsoft (a GitHub organization, an official publisher) maintains it in microsoft/aspire, which has 6,359 GitHub stars. The repository holds 22 skills in this directory. The repository was last updated on October 11, 2026.
Source: microsoft/aspire on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.