One search for your own team's files and the public ecosystem. See how real projects write their agent instructions, and bring the good ideas home.
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
MicrosoftSkillmicrosoft/aspire/.agents/skills/backport-pr/SKILL.md
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?). Use when asked to: backport a PR, port a fix to a release branch, fill in a backport template, prepare a backport for shiproom review.
5 projects use a version of this
MicrosoftSkillmicrosoft/aspire/.agents/skills/bump-aspire-version/SKILL.md
Bumps the Aspire repository product version in eng/Versions.props using previous version-bump commits as guidance. Use when asked to bump Aspire branding, advance the repository to a new major or minor version, or create a version-bump PR. Not for external dependency, SDK, or container-image updates.
MicrosoftSkillmicrosoft/aspire/.agents/skills/cli-channel-debugging/SKILL.md
Emulates any Aspire CLI build identity (channel, version, commit, package source) from a locally built CLI using ASPIRE_CLI_* environment variables and the install sidecar, so a reported bug can be reproduced and fixed locally without going through the install/PR loop. Use this when asked to reproduce channel/version/quality-specific CLI behavior, simulate a daily/staging/stable/PR build locally, or decide which override knobs to set for a given scenario.
1 project uses a version of this
MicrosoftSkillmicrosoft/aspire/.agents/skills/code-review/SKILL.md
Review a GitHub pull request or requested local diff for problems. Use when asked to review a PR, do a code review, check a PR for issues, or review local changes. Focuses only on identifying problems — not style nits or praise.
Often used withclose-specadd-new-modelcompare-screenshots
MicrosoftSkillmicrosoft/aspire/.agents/skills/connection-properties/SKILL.md
Specialized agent for creating and improving Connection Properties in Aspire resource and README files
1 project uses a version of this
MicrosoftSkillmicrosoft/aspire/.agents/skills/create-pr/SKILL.md
Create a pull request using the repository PR template. Use when asked to: create PR, open PR, push and create PR, submit PR, open pull request, send changes for review.
Often used withupdate-pr
MicrosoftSkillmicrosoft/aspire/.agents/skills/create-video/SKILL.md
Produces narrated Aspire videos (feature walkthroughs, dashboard tours, integration overviews, pull request demos) with one unified look and specification - 1080p, the Aspire logo and purple palette from aspire.dev, a neural voice picked from a shortlist, captions, slight dynamic zooms on demos, and renditions for GitHub, aspire.dev, YouTube or chat apps. Use when asked to record, narrate, or produce a video of Aspire, its dashboard or its CLI: narrated and branded by default, or silent or unbranded when the user asks for a simpler video.
MicrosoftSkillmicrosoft/aspire/.agents/skills/dashboard-testing/SKILL.md
Guide for writing tests for the Aspire Dashboard. Use this when asked to create, modify, or debug dashboard unit tests or Blazor component tests.
1 project uses a version of this
MicrosoftSkillmicrosoft/aspire/.agents/skills/dependency-update/SKILL.md
Guides dependency version updates by checking nuget.org for latest versions, triggering the dotnet-migrate-package Azure DevOps pipeline, and monitoring runs. Use this when asked to update external NuGet dependencies.
8 projects use a version of this
MicrosoftSkillmicrosoft/aspire/.agents/skills/deployment-e2e-testing/SKILL.md
Guide for writing Aspire deployment end-to-end tests. Use this when asked to create, modify, or debug deployment E2E tests that deploy to Azure.
1 project uses a version of this
MicrosoftSkillmicrosoft/aspire/.agents/skills/deprecate-integration/SKILL.md
Sunsets (soft-deprecates) a shipped Aspire hosting integration: marks its public API [Obsolete], adds a README warning banner, hides the package from `aspire add`, removes integration-specific automation, suppresses the resulting warnings in first-party consumers, and ships one final obsolete release. Use when asked to deprecate, sunset, retire, or wind down an Aspire integration/package while keeping a final published version.
1 project uses a version of this
MicrosoftSkillmicrosoft/aspire/.agents/skills/fix-flaky-test/SKILL.md
Reproduces and fixes flaky or quarantined tests. Tries local reproduction first (fast), then falls back to CI reproduce workflow (reproduce-flaky-tests.yml). Use this when asked to investigate, reproduce, debug, or fix a flaky test, a quarantined test, or an intermittently failing test.
2 projects use a version of this
MicrosoftSkillmicrosoft/aspire/.agents/skills/hex1b/SKILL.md
CLI tool for automating any terminal application — TUI apps, shells, CLI tools, REPLs, and more. Use when you need to launch a process in a virtual terminal, capture its screen output, inject keystrokes or mouse input, take screenshots, record sessions, or assert on what's visible.
2 projects use a version of this
MicrosoftSkillmicrosoft/aspire/.agents/skills/hosting-integration-authoring/SKILL.md
Guides authoring and reviewing Aspire.Hosting integration APIs. Classifies integration archetypes, then applies self-contained best practices for naming, resource shape, run/publish/deploy behavior, eventing, connection properties, security, endpoint semantics, polyglot exports, READMEs, and tests.
2 projects use a version of this
MicrosoftSkillmicrosoft/aspire/.agents/skills/issue-investigation/SKILL.md
Investigates GitHub issues in microsoft/aspire by gathering issue context, routing to specialized skills, preparing the right reproduction environment, reproducing behavior, and drafting evidence-backed findings or insufficient-info comments for user approval. Use when asked to investigate, reproduce, validate, debug, triage, or root-cause an Aspire issue.
1 project uses a version of this
MicrosoftSkillmicrosoft/aspire/.agents/skills/reviewing-aspire-architecture/SKILL.md
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.
1 project uses a version of this
MicrosoftSkillmicrosoft/aspire/.agents/skills/startup-perf/SKILL.md
Measures Aspire startup profiling with CLI self-profile capture and dashboard export traces.
1 project uses a version of this
MicrosoftSkillmicrosoft/aspire/.agents/skills/test-management/SKILL.md
Quarantines or disables flaky/problematic tests using the QuarantineTools utility
MicrosoftSkillmicrosoft/aspire/.agents/skills/update-container-images/SKILL.md
Updates Docker container image tags used by Aspire hosting integrations. Queries registries for newer tags, uses LLM to determine version-compatible updates, and applies changes. Use this when asked to update container image versions.
1 project uses a version of this
MicrosoftSkillmicrosoft/aspire/.agents/skills/vscode-extension/SKILL.md
Use when investigating, developing, debugging, testing, or reviewing Aspire VS Code extension behavior under extension/, including extension UI, command, debugger, RPC, DCP, MCP, and CLI-integration issues or features.
3 projects use a version of this
Plain text files in a repository that tell a coding agent how the project works: commands to run, conventions to follow and things to avoid. CLAUDE.md, AGENTS.md, cursor rules and skills are the common kinds.
CLAUDE.md is read by Claude Code. AGENTS.md is an open format that Codex, Cursor and other agents read. Many projects keep one and point the other at it.
A folder with a SKILL.md that describes one capability, such as filling PDFs or reviewing code. The agent loads it only when the task calls for it.
Your agents already can, over MCP, limited to the files you're allowed to read. Searching them from this page is coming.
