Official agent skill

Reviewing Aspire Architecture

by microsoft in microsoft/aspire

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…

OfficialMITAuto-check passedDevelopment

Install Reviewing Aspire Architecture

skills CLI
$ npx skills add microsoft/aspire --skill reviewing-aspire-architecture -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install microsoft/aspire reviewing-aspire-architecture --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ 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-src

Use ~/.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/

Facts

Skill name
reviewing-aspire-architecture
GitHub stars
6.4k
Token cost
~1.3k tokens
SKILL.md length
647 words
Files
1
Skills in repo
22
Repo updated
First seen
Licence
MIT

At a glance

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…

  • Explicitly requests a deep Aspire architectural
  • SKILL.md covers When to Use, Invocation Guard, Relationship to code-review and Review Scope, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Pattern review of an existing PR

What it does

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.

When your agent uses it

  • 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

Example prompts

  • “/reviewing-aspire-architecture”

What it can do on your machine

Read from SKILL.md and the folder at commit a1f8cbd. It shows what the files ask for, not the result of running them.

  • Tool permissions

    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.

  • Runs code

    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.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

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.

Always · name and description, kept in context so the agent knows when to use it
~101
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

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.

Safety

Auto-check passed

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.

SKILL.md

The full file from microsoft/aspire at commit a1f8cbd, republished under its MIT licence (© microsoft). 647 words, ~1,338 tokens.

Download SKILL.mdSave it as .claude/skills/reviewing-aspire-architecture/SKILL.md (or your agent's skills folder).
name
reviewing-aspire-architecture
description
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.

Aspire Architectural Review

Aspire-specific architectural review via the reviewing-aspire-architecture agent. Catches domain patterns that generic code-review cannot.

When to Use

Use only when at least one of these conditions is true:

  • The user explicitly asks for a deep architectural review, Aspire pattern review, or equivalent domain-focused review of an existing PR or diff.
  • A generic review has completed and found a concrete question that cannot be resolved without Aspire-specific architectural knowledge. The reviewer must state the relevant diff evidence, unresolved question, applicable Aspire contract, and why its normal review cannot determine correctness; invoke this skill with only that focused question. Do not escalate merely for additional confidence or a second opinion.

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.

Invocation Guard

  • A parent may load this skill once and launch one reviewing-aspire-architecture agent for a user review request and change-set revision.
  • If this skill context is already loaded, do not invoke the skill again.
  • If the current agent is reviewing-aspire-architecture, do not invoke this skill or launch another reviewing-aspire-architecture agent.
  • Continue follow-up work in the existing agent conversation. Do not launch a replacement agent for refinements or narrower follow-up questions.
  • Completing or modifying code does not automatically trigger another architectural review. Re-run only when the user explicitly requests it for a materially changed diff.
Show full SKILL.md (298 more words)Show less

Relationship to code-review

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.

Review Scope

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 → Dimension Routing

FolderDimensions
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

Files

Just SKILL.md in .agents/skills/reviewing-aspire-architecture of microsoft/aspire.

Open the folder on GitHubat commit a1f8cbd

Compare with similar skills

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.

Reviewing Aspire Architecture compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Reviewing Aspire Architecture this skillmicrosoft/aspire6.4k—~1.3kAutomated safety check: PassMIT
Microsoft Code ReferenceMicrosoftDocs/mcp1.9k3 repos~1.1kAutomated safety check: PassCC-BY-4.0
Version ReleaseNG-ZORRO/ng-zorro-antd9.2k—~3.1kAutomated safety check: PassMIT
DeepChat Provider IntegrationThinkInAIXYZ/deepchat6.4k—~1.2kAutomated safety check: PassApache-2.0
Code ReviewAzure/Azurite2.3k—~734Automated safety check: PassMIT
Add ModelPipelex/pipelex942—~2.8kAutomated safety check: PassCustom licence

Similar skills

  • Microsoft Code Reference

    MicrosoftDocs/mcp

    Official

    Find working code samples, verify API signatures, and fix Microsoft SDK errors using official docs.

    1.9k GitHub starsUsed in 3 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Version Release

    NG-ZORRO/ng-zorro-antd

    NG-ZORRO/ng-zorro-antd repository release workflow. An agent skill from NG-ZORRO/ng-zorro-antd.

    9.2k GitHub stars~3.1k tokensUpdated today
    DevelopmentAuto-check passed
  • DeepChat Provider Integration

    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.

    6.4k GitHub stars~1.2k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Code Review

    Azure/Azurite

    Official

    Review Azurite pull requests with service-aware checks for Blob, Queue, and Table behavior, API compatibility, tests, and release notes.

    2.3k GitHub stars~734 tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Add Model

    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…

    942 GitHub stars~2.8k tokensUpdated today
    DevelopmentAuto-check passed
  • Official

    Writes customer-facing release notes for Azure App Configuration libraries and providers in a fixed file layout, version heading and category structure.

    263 GitHub stars~3.1k tokensUpdated 6 days ago
    DevelopmentAuto-check passed

More from microsoft/aspire

All 22 skills in this repo
  • Azdo Internal

    microsoft/aspire

    Official

    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…

    6.4k GitHub stars~4.5k tokensUpdated today
    Auto-check passed
  • Backport PR

    microsoft/aspire

    Official

    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?).

    6.4k GitHub stars~4.2k tokensUpdated today
    Auto-check passed
  • Bump Aspire Version

    microsoft/aspire

    Official

    Bumps the Aspire repository product version in eng/Versions.props using previous version-bump commits as guidance.

    6.4k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • CI Test Failures

    microsoft/aspire

    Official

    Guide for diagnosing GitHub Actions test failures, extracting failed tests from runs, and creating or updating failing-test issues.

    6.4k GitHub stars~4.7k tokensUpdated today
    Auto-check passed
  • Create PR

    microsoft/aspire

    Official

    Create a pull request using the repository PR template. An agent skill from microsoft/aspire.

    6.4k GitHub stars~4k tokensUpdated today
    Auto-check passed
  • Dashboard Testing

    microsoft/aspire

    Official

    Guide for writing tests for the Aspire Dashboard. An agent skill from microsoft/aspire.

    6.4k GitHub stars~4.7k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Reviewing Aspire Architecture

What does Reviewing Aspire Architecture do?

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.

When should I use Reviewing Aspire Architecture?

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.

How do I install Reviewing Aspire Architecture in Claude Code?

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.

How do I install Reviewing Aspire Architecture in Codex?

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.

Can I use Reviewing Aspire Architecture in Cursor, Gemini CLI or GitHub Copilot?

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.

What does Reviewing Aspire Architecture need to run?

SKILL.md names no scripts, command-line tools or credentials: Reviewing Aspire Architecture is instructions for the agent only.

Does Reviewing Aspire Architecture access the network?

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.

Is Reviewing Aspire Architecture safe to install?

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.

What licence does Reviewing Aspire Architecture use?

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.

How many tokens does Reviewing Aspire Architecture use?

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.

What are the alternatives to Reviewing Aspire Architecture?

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.

Who maintains Reviewing Aspire Architecture?

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.