{
  "markdown": "# Aspire Skills\n\nAspire Skills is a plugin, skill pack, and extension pack for AI coding agents working on Aspire distributed applications.\n\nIt 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.\n\n## What's included\n\n### Skills\n\n| Skill | Purpose |\n|-------|---------|\n| `aspire` | Top-level router for Aspire projects |\n| `aspire-init` | Creates a new Aspire project or adds an Aspire skeleton to an existing repo |\n| `aspireify` | Wires an AppHost after `aspire init` |\n| `aspire-orchestration` | Starts, stops, waits for, and manages Aspire resources |\n| `aspire-deployment` | Publishes, deploys, and tears down Aspire apps |\n| `aspire-monitoring` | Routes logs, traces, dashboard, telemetry, and diagnostics work |\n\n### Extensions\n\n| Extension | Purpose |\n|-----------|---------|\n| `aspire-doctor` | Opens a Copilot canvas for `aspire doctor` results, showing environment checks, fixes, and detected CLI installations |\n\n## Install\n\nChoose the path that matches your agent host.\n\n### Aspire CLI\n\nAspire's first-party agent setup installs Aspire skill files, extension files, and MCP configuration into detected agent environments.\n\n```bash\n# Create a new Aspire app and opt into agent guidance when prompted\naspire new\n\n# Or add Aspire to an existing repo and opt into agent guidance when prompted\naspire init\n\n# Add, update, or reconfigure Aspire guidance in an existing workspace\naspire agent init\n```\n\n### Agent plugins and extensions\n\n#### GitHub Copilot app\n\nThe GitHub Copilot app plugin installs Aspire skills and canvas extensions for\nthe current user.\n\n##### Prerequisites\n\nBefore you install, make sure you have:\n\n- [GitHub Copilot app](https://gh.io/app) installed.\n- A GitHub Copilot subscription (paid or free).\n\n##### Install\n\nInstall the `microsoft/aspire-skills` marketplace through the GitHub Copilot\napp:\n\n1. 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)\n   to automatically open the **Settings** > **Plugins** window in the GitHub\n   Copilot app.\n2. In the **Add plugin marketplace?** dialog, select **Allow**.\n3. The **Plugins** window opens with the `microsoft/aspire-skills` marketplace.\n   Select **Add marketplace**.\n4. Expand the `aspire-skills` entry and select **Install** on the `aspire`\n   plugin.\n\n#### Command-line hosts\n\n```bash\n# GitHub Copilot CLI\ncopilot plugin marketplace add microsoft/aspire-skills\ncopilot plugin install aspire@aspire-skills\n\n# Claude Code CLI\nclaude\n/plugin marketplace add microsoft/aspire-skills\n/plugin install aspire@aspire-skills\n\n# Codex CLI\ncodex plugin marketplace add microsoft/aspire-skills\n# then open /plugins and install aspire\n\n# Gemini CLI\ngemini extensions install https://github.com/microsoft/aspire-skills\n\n# Cursor CLI\nmkdir -p ~/.cursor/skills\ngit clone https://github.com/microsoft/aspire-skills ~/.cursor/skills/aspire-skills\nagent\n\n# OpenCode\napm install microsoft/aspire-skills\nopencode\n\n# Ollama + Copilot CLI\nollama launch copilot\ncopilot plugin marketplace add microsoft/aspire-skills\ncopilot plugin install aspire@aspire-skills\n```\n\n### skills.sh via NPX\n\nUse the Skills-compatible installer when your agent host supports skills.sh-managed skill locations.\n\n```bash\nnpx skills add microsoft/aspire-skills\n```\n\nFor hosts that need an explicit skills directory and target agent, install from the `skills/` folder:\n\n```bash\nnpx skills add https://github.com/microsoft/aspire-skills/tree/main/skills \\\n  -a github-copilot -g -y\n```\n\nIn that command, `-a github-copilot` selects the target agent, `-g` installs globally, and `-y` accepts prompts.\n\n## Repository layout\n\n| Path | Purpose |\n|------|---------|\n| `skills/` | Source skill files, references, and evals |\n| `extensions/` | Source GitHub Copilot app canvas extensions |\n| `hooks/scripts/` | Canonical Aspire CLI agent telemetry hooks |\n| `.plugin/`, `.claude-plugin/`, `.cursor-plugin/` | Plugin metadata for marketplaces |\n| `.github/plugins/aspire-skills/` | Published plugin mirror |\n| `evals/` | Shared evaluation fixtures and helpers |\n\n## Development\n\n```bash\nnpm run bundle\n```\n\n`npm run bundle` builds both published release artifacts:\n\n| Artifact | Contents |\n|----------|----------|\n| `aspire-skills-v<version>.tgz` | Agent skill files, canonical telemetry hooks, and `skill-manifest.json` with hook commit/SHA-512 provenance |\n| `aspire-extensions-v<version>.tgz` | GitHub Copilot app canvas extension files and `extension-manifest.json` |\n\nThe skills manifest records the release commit and LF-normalized SHA-512 hash for\neach file under `hooks/scripts/`. Downstream consumers can copy the `hooks` object\ndirectly instead of maintaining hook provenance separately.\n\nUse `npm run bundle:skills` or `npm run bundle:extensions` to build one bundle type.\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines.\n\n## License\n\n[MIT](LICENSE)\n",
  "bytes": 5127,
  "sha": "444fb82450398c728ff422f9f05d5cdbe6901ed8986cb1472092661b94737a87",
  "repo_slug": "microsoft/aspire-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_microsoft_aspire_skills_2f7153d8/readme"
}