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.
MicrosoftSkillmicrosoft/apm/.agents/skills/oss-growth/SKILL.md
Activate for OSS adoption work -- README conversion surfaces, quickstart, templates, release announcements, contributor funnel, story angles -- and any update to the maintained growth strategy at WIP/growth-strategy.md.
MicrosoftSkillmicrosoft/apm/.agents/skills/pr-description-skill/SKILL.md
Use this skill to write the PR description (PR body) for any pull request opened against microsoft/apm. Produces one self-sufficient GitHub-Flavored Markdown artifact: TL;DR, Problem (WHY), Approach (WHAT), Implementation (HOW), 1-3 validated mermaid diagrams, explicit trade-offs, validation evidence, and a How-to-test section -- with every WHY-claim backed by a verbatim quote from PROSE or Agent Skills. Activate when the user asks to "write a PR description", "draft a PR body", "open a PR", "fill in the PR template", or any equivalent.
MicrosoftSkillmicrosoft/apm/.agents/skills/python-architecture/SKILL.md
Activate when creating new modules, refactoring class hierarchies, introducing design patterns, or making changes spanning 3+ files in the APM CLI codebase.
MicrosoftSkillmicrosoft/apm/.agents/skills/supply-chain-security/SKILL.md
Activate when reviewing or modifying dependency resolution, lockfile schema, package downloaders, signature/integrity checks, file integration cleanup, or anything that could expose APM to dependency confusion, typosquatting, malicious packages, or token leakage.
MicrosoftSkillmicrosoft/apm/.apm/skills/apm-spec-guardian/SKILL.md
Use this skill to run a four-panel adversarial advisory review on any pull request that touches the OpenAPM specification artifact (docs/src/content/docs/specs/openapm-*.md), its inline / sidecar JSON Schemas (docs/src/content/docs/specs/schemas/*.schema.json), or the conformance fixture seed (tests/fixtures/spec-conformance/**). The panel fans out to four spec-ecosystem reviewers (swagger-openapi-editor, oci-distribution-editor, pkgmgr-registry-contract-editor, w3c-tag-architect), each running in its own agent thread, and a spec-editor synthesizer that produces a fold-now / defer-v0.1.1 / defer-v0.2 / reject list plus a ship decision keyed off a 1..10 shocked_meter scale. The orchestrator is the sole writer to the PR: ONE consolidated comment, no verdict labels, no merge gating. The panel is advisory -- it surfaces findings, prioritizes folds, and renders a ship recommendation that the maintainer weighs.
MicrosoftSkillmicrosoft/apm/.apm/skills/apm-strategy/SKILL.md
Activate for changes to project positioning, release communication, community-facing artifacts, or breaking-change decisions in microsoft/apm. Triggers on README, MANIFESTO, PRD, CHANGELOG, release workflows, and issue templates.
MicrosoftSkillmicrosoft/apm/.apm/skills/cli-logging-ux/SKILL.md
Use this skill when editing or creating CLI output, logging, warnings, error messages, progress indicators, or diagnostic summaries in the APM codebase. Activate whenever code touches console helpers (_rich_success, _rich_warning, _rich_error, _rich_info, _rich_echo), DiagnosticCollector, STATUS_SYMBOLS, CommandLogger, or any user-facing terminal output — even if the user doesn't mention "logging" or "UX" explicitly.
MicrosoftSkillmicrosoft/apm/.apm/skills/devx-ux/SKILL.md
Activate when designing or modifying CLI command surfaces, command help text, install/init/run flows, error wording, or first-run experience in the APM CLI -- even when the user does not say "UX" explicitly.
MicrosoftSkillmicrosoft/apm/.apm/skills/docs-corpus-audit/SKILL.md
Use this skill to run a holistic regrounding pass on the entire microsoft/apm documentation corpus against current source code, page-by-page, and emit surgical fixes for stale claims. Activate when the maintainer wants a WHOLE-CORPUS audit (not per-PR review) -- typical triggers include "audit the docs", "reground the corpus", "check every page against code", "pre-release docs sweep", "the docs have drifted everywhere", or "we just reshaped the TOC, find dead links". Wave-batched and S7-verified; scales to the full ~112-page corpus in ~10 minutes wall-time. This is a SIBLING to docs-sync, not a replacement: docs-sync is per-PR (triggered by a diff); this skill is per-corpus (triggered by a maintainer ask). They share agent personas, schemas, and the docs index, but their triggers MUST NOT collide. Does NOT auto-merge, does NOT push without maintainer review, and does NOT replace per-PR drift detection.
MicrosoftSkillmicrosoft/apm/.apm/skills/docs-sync/SKILL.md
Use this skill whenever a pull request is opened, reopened, or synchronized in microsoft/apm to assess whether and how the documentation corpus must change to stay truthful with the proposed code change. Activate even when the PR title or body says nothing about docs -- the skill must run on every PR to detect silent drift between code and docs. Classifies impact as no-change, in-place edit (one to a few paragraphs), or structural change (new page or TOC reshape), then orchestrates a CDO + doc-writer + python-architect + editorial-owner + growth-hacker loop to produce a patch-ready advisory. Does NOT review code quality, security, or test coverage. Does NOT auto-merge or auto-push doc edits.
MicrosoftSkillmicrosoft/apm/.apm/skills/oss-growth/SKILL.md
Activate for OSS adoption work -- README conversion surfaces, quickstart, templates, release announcements, contributor funnel, story angles -- and any update to the maintained growth strategy at WIP/growth-strategy.md.
MicrosoftSkillmicrosoft/apm/.apm/skills/python-architecture/SKILL.md
Activate when creating new modules, refactoring class hierarchies, introducing design patterns, or making changes spanning 3+ files in the APM CLI codebase.
MicrosoftSkillmicrosoft/apm/.apm/skills/supply-chain-security/SKILL.md
Activate when reviewing or modifying dependency resolution, lockfile schema, package downloaders, signature/integrity checks, file integration cleanup, or anything that could expose APM to dependency confusion, typosquatting, malicious packages, or token leakage.
MicrosoftCopilot instructionsmicrosoft/apm/.github/copilot-instructions.md
The CI Lint job is a hard gate. Mirror it locally before git push and before producing any artifact (PR body, release note, audit report) that claims CI is green. The Lint job runs (see .github/workflows/ci.yml): 1. uv run --extra dev ruff check src/ tests/ 2. uv run --extra dev ruff format --check src/ tests/ 3. YAML I/O safety guard (rejects raw yaml.dump(..., handle) outside utils/yaml_io.py; mark approved exceptions with # yaml-io-exempt). 4. File length guardrail (no src/*/.py may exceed…
MicrosoftCopilot instructionsmicrosoft/apm/packages/apm-contributor-dashboard/.github/copilot-instructions.md
This package ships a canvas extension. No agent instructions are needed.
MicrosoftSkillmicrosoft/apm/packages/apm-guide/.apm/skills/apm-usage/SKILL.md
Activate when the user asks about APM (Agent Package Manager): installing, configuring, authoring, or troubleshooting AI-agent packages, dependencies, compilation, MCP servers, policy, or any `apm` CLI command.
MicrosoftCopilot instructionsmicrosoft/apm/packages/autopilot/autopilot-maintainer-canvas/.github/copilot-instructions.md
This package ships a canvas extension. No agent instructions are needed.
MicrosoftAGENTS.mdmicrosoft/apm/templates/hello-world/AGENTS.md
You are a helpful AI assistant focused on clean, maintainable code and best practices. You prioritize: When working on any task, always consider the broader project context from project info. This is a demonstration project showcasing APM (Agent Primitives Manager) primitives compilation into AGENTS.md format. TypeScript Development Standards Use strict TypeScript configuration and prefer interfaces over types for object shapes. Implement proper generic constraints and avoid any type. Code Structure - Use barrel exports for clean imports - Implement proper…
MicrosoftSkillmicrosoft/apm/templates/hello-world/SKILL.md
{{description}}
MicrosoftSkillmicrosoft/apm/tests/fixtures/agent_plugins/portable/skills/contract-skill/SKILL.md
Hermetic Agent Plugins lifecycle contract
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.
