Meta Agent Tools
PT

Back to the catalog

aspire

Aspire skills plugin for AI coding agents. Six skills covering routing, init, AppHost wiring (aspireify), orchestration, deployment, and mon

Open source Open in the app JSON README (API)

About

Aspire skills plugin for AI coding agents. Six skills covering routing, init, AppHost wiring (aspireify), orchestration, deployment, and monitoring. Aligned with Aspire 13.5.3.

Details

Kind
Plugins
Topic
Cloud & DevOps
Publisher
microsoft
Origin
gemini
Category
ferramentas
Version
0.0.2
Stars
86
Forks
10
Open pull requests
10
Last push
2026-09-04T21:08:57Z
Repository state
ativo
Language
TypeScript
License
MIT
Added
2026-08-30 14:13:39
Updated
2026-09-01 15:00:44
Origin id
microsoft/aspire-skills

README

# Aspire Skills

Aspire Skills is a plugin, skill pack, and extension pack for AI coding agents working on Aspire distributed applications.

It helps agents recognize Aspire workspaces, use the Aspire CLI correctly, route common work to focused skills instead of ad hoc `dotnet`, `curl`, Docker, or shell workflows, and surface focused visual tools for Aspire-specific tasks.

## What's included

### Skills

| Skill | Purpose |
|-------|---------|
| `aspire` | Top-level router for Aspire projects |
| `aspire-init` | Creates a new Aspire project or adds an Aspire skeleton to an existing repo |
| `aspireify` | Wires an AppHost after `aspire init` |
| `aspire-orchestration` | Starts, stops, waits for, and manages Aspire resources |
| `aspire-deployment` | Publishes, deploys, and tears down Aspire apps |
| `aspire-monitoring` | Routes logs, traces, dashboard, telemetry, and diagnostics work |

### Extensions

| Extension | Purpose |
|-----------|---------|
| `aspire-doctor` | Opens a Copilot canvas for `aspire doctor` results, showing environment checks, fixes, and detected CLI installations |

## Install

Choose the path that matches your agent host.

### Aspire CLI

Aspire's first-party agent setup installs Aspire skill files, extension files, and MCP configuration into detected agent environments.

```bash
# Create a new Aspire app and opt into agent guidance when prompted
aspire new

# Or add Aspire to an existing repo and opt into agent guidance when prompted
aspire init

# Add, update, or reconfigure Aspire guidance in an existing workspace
aspire agent init
```

### Agent plugins and extensions

#### GitHub Copilot app

The GitHub Copilot app plugin installs Aspire skills and canvas extensions for
the current user.

##### Prerequisites

Before you install, make sure you have:

- [GitHub Copilot app](https://gh.io/app) installed.
- A GitHub Copilot subscription (paid or free).

##### Install

Install the `microsoft/aspire-skills` marketplace through the GitHub Copilot
app:

1. Click [this link](https://github.com/copilot/app/launch?entry_point=aspire_skills_docs&open=ghapp%3A%2F%2Fplugins%2Fmarketplace%2Fadd%3Fsource%3Dmicrosoft%2Faspire-skills)
   to automatically open the **Settings** > **Plugins** window in the GitHub
   Copilot app.
2. In the **Add plugin marketplace?** dialog, select **Allow**.
3. The **Plugins** window opens with the `microsoft/aspire-skills` marketplace.
   Select **Add marketplace**.
4. Expand the `aspire-skills` entry and select **Install** on the `aspire`
   plugin.

#### Command-line hosts

```bash
# GitHub Copilot CLI
copilot plugin marketplace add microsoft/aspire-skills
copilot plugin install aspire@aspire-skills

# Claude Code CLI
claude
/plugin marketplace add microsoft/aspire-skills
/plugin install aspire@aspire-skills

# Codex CLI
codex plugin marketplace add microsoft/aspire-skills
# then open /plugins and install aspire

# Gemini CLI
gemini extensions install https://github.com/microsoft/aspire-skills

# Cursor CLI
mkdir -p ~/.cursor/skills
git clone https://github.com/microsoft/aspire-skills ~/.cursor/skills/aspire-skills
agent

# OpenCode
apm install microsoft/aspire-skills
opencode

# Ollama + Copilot CLI
ollama launch copilot
copilot plugin marketplace add microsoft/aspire-skills
copilot plugin install aspire@aspire-skills
```

### skills.sh via NPX

Use the Skills-compatible installer when your agent host supports skills.sh-managed skill locations.

```bash
npx skills add microsoft/aspire-skills
```

For hosts that need an explicit skills directory and target agent, install from the `skills/` folder:

```bash
npx skills add https://github.com/microsoft/aspire-skills/tree/main/skills \
  -a github-copilot -g -y
```

In that command, `-a github-copilot` selects the target agent, `-g` installs globally, and `-y` accepts prompts.

## Repository layout

| Path | Purpose |
|------|---------|
| `skills/` | Source skill files, references, and evals |
| `extensions/` | Source GitHub Copilot app canvas extensions |
| `hooks/scripts/` | Canonical Aspire CLI agent telemetry hooks |
| `.plugin/`, `.claude-plugin/`, `.cursor-plugin/` | Plugin metadata for marketplaces |
| `.github/plugins/aspire-skills/` | Published plugin mirror |
| `evals/` | Shared evaluation fixtures and helpers |

## Development

```bash
npm run bundle
```

`npm run bundle` builds both published release artifacts:

| Artifact | Contents |
|----------|----------|
| `aspire-skills-v<version>.tgz` | Agent skill files, canonical telemetry hooks, and `skill-manifest.json` with hook commit/SHA-512 provenance |
| `aspire-extensions-v<version>.tgz` | GitHub Copilot app canvas extension files and `extension-manifest.json` |

The skills manifest records the release commit and LF-normalized SHA-512 hash for
each file under `hooks/scripts/`. Downstream consumers can copy the `hooks` object
directly instead of maintaining hook provenance separately.

Use `npm run bundle:skills` or `npm run bundle:extensions` to build one bundle type.

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines.

## License

[MIT](LICENSE)

More