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/agent-framework/.github/skills/pull-requests/SKILL.md
Guidance for creating pull requests and handling PR review comments in the Agent Framework repository. Use this when writing a PR description (filling out the PR template) or when responding to and resolving review comments on an existing PR.
Steady11 mentions in 2 weeks
15 projects use a version of this
MicrosoftAGENTS.mdmicrosoft/agent-framework/python/AGENTS.md
Instructions for AI coding agents working in the Python codebase. Key Documentation: - DEV_SETUP.md - Development environment setup and available poe tasks - CODING_STANDARD.md - Canonical Python engineering and API-design standards - samples/SAMPLE_GUIDELINES.md - Sample structure and guidelines - Python function-calling loop specification - Required behavior, scenario-to-test mapping, coverage gaps, and extra validation for function-loop changes Agent Skills (.github/skills/) — detailed, task-specific instructions loaded on demand: - python-development — Python development workflow and routing to the canonical standards and task-specific…
MicrosoftSkillmicrosoft/agent-framework/python/.github/skills/agent-framework-py-release/SKILL.md
Use when cutting a Python release for the microsoft/agent-framework monorepo. Triggers on "bump py versions", "cut a python release", "prepare release PR for python", "release py packages", "bump python to X.Y.Z", or similar requests to bump Python package versions and prepare a release PR. Handles all four lifecycle tiers with CHANGELOG-driven selective bumps, a reviewed batch manifest, dependency checks, and the protected Azure DevOps release handoff.
MicrosoftSkillmicrosoft/agent-framework/python/.github/skills/pull-requests/SKILL.md
Guidance for creating pull requests and handling PR review comments in the Agent Framework repository. Use this when writing a PR description (filling out the PR template) or when responding to and resolving review comments on an existing PR.
Steady11 mentions in 2 weeks
15 projects use a version of this
MicrosoftSkillmicrosoft/agent-framework/python/.github/skills/python-code-quality/SKILL.md
Code quality checks, linting, formatting, and type checking commands for the Agent Framework Python codebase. Use this when running checks, fixing lint errors, or troubleshooting CI failures.
Steady11 mentions in 2 weeks
No other project uses it yet
MicrosoftSkillmicrosoft/agent-framework/python/.github/skills/python-development/SKILL.md
Workflow guidance for developing Python code in the Agent Framework repository. Use this when writing or modifying Python source files under python/.
Steady11 mentions in 2 weeks
13 projects use a version of this
MicrosoftSkillmicrosoft/agent-framework/python/.github/skills/python-feature-lifecycle/SKILL.md
Guidance for package and feature lifecycle in the Agent Framework Python codebase, including stage meanings, feature-stage decorators, feature enums, and how to move APIs from one stage to the next.
Steady11 mentions in 2 weeks
No other project uses it yet
MicrosoftSkillmicrosoft/agent-framework/python/.github/skills/python-testing/SKILL.md
Guidelines for writing and running tests in the Agent Framework Python codebase. Use this when creating, modifying, or running tests.
Steady11 mentions in 2 weeks
53 projects use a version of this
Often used withdjango-verificationpython-patternsproject-guidelines-example
MicrosoftAGENTS.mdmicrosoft/agent-framework/python/packages/a2a/AGENTS.md
Agent-to-Agent (A2A) protocol support for inter-agent communication. A2A protocol metadata is stored under additional_properties["a2a"]. The legacy a2a_metadata key remains readable and is dual-written during the compatibility period defined by spec 005. Consuming legacy-only input emits FutureWarning; new callers should write only the canonical a2a key.
Steady11 mentions in 2 weeks
No other project uses it yet
MicrosoftAGENTS.mdmicrosoft/agent-framework/python/packages/ag-ui/AGENTS.md
AG-UI protocol integration for building agent UIs with the AG-UI standard. - AgentFrameworkAgent - Wraps agents for AG-UI compatibility - AgentFrameworkWorkflow - Wraps native Workflow objects, or accepts workflow_factory(thread_id) for thread-scoped workflow instances without subclassing - AGUIChatClient - Chat client that speaks AG-UI protocol - AGUIHttpService - HTTP service for AG-UI endpoints - agent_framework_messages_to_agui_host_history() - Converts persisted Agent Framework messages to bounded AG-UI Host history while retaining MCP widget payloads and model replay metadata - AGUIEventConverter - Converts between Agent…
Steady11 mentions in 2 weeks
No other project uses it yet
MicrosoftAGENTS.mdmicrosoft/agent-framework/python/packages/anthropic/AGENTS.md
Integration with Anthropic's Claude API.
Steady11 mentions in 2 weeks
No other project uses it yet
MicrosoftAGENTS.mdmicrosoft/agent-framework/python/packages/azure-contentunderstanding/AGENTS.md
agent-framework-azure-contentunderstanding integrates Azure Content Understanding (CU) into the Agent Framework as a context provider. It automatically analyzes file attachments (documents, images, audio, video) and injects structured results into the LLM context. - _context_provider.py — Main provider implementation. Overrides before_run() to detect file attachments, call the CU API, manage session state with multi-document tracking, and auto-register retrieval tools for follow-up turns. - Analyzer auto-detection — When analyzer_id=None (default), _resolve_analyzer_id() selects the CU analyzer based on media type prefix: audio/ → prebuilt-audioSearch,…
Steady11 mentions in 2 weeks
No other project uses it yet
MicrosoftAGENTS.mdmicrosoft/agent-framework/python/packages/azure-cosmos/AGENTS.md
Azure Cosmos DB for NoSQL integrations for Agent Framework. Container name is configured on the provider. session_id is used as the partition key. Vector collections require an application-provided string key stored as id and a container partition key of /id. Container vector and indexing policies are created only by ensure_collection_exists() and validated before use. Existing incompatible containers are never updated or recreated. Supported vector element types are float32, int8, and uint8. Euclidean search is supported, but Euclidean score thresholds fail…
Steady11 mentions in 2 weeks
No other project uses it yet
MicrosoftAGENTS.mdmicrosoft/agent-framework/python/packages/azure-cosmos-memory/AGENTS.md
Long-term semantic memory for agents, backed by Azure Cosmos DB via the Azure Cosmos DB Agent Memory Toolkit. - CosmosMemoryContextProvider - Context provider that integrates Cosmos DB-backed semantic memory (facts, procedural/episodic memories, and user/thread summaries) into agents. - Requires the azure-cosmos-agent-memory toolkit and an AI Foundry endpoint (used for both embeddings and fact extraction). - Documentation and examples that show a literal Foundry project endpoint must use the full project-scoped form https://your-account.services.ai.azure.com/api/projects/your-project, including the /api/projects/your-project path. - Set a stable…
Steady11 mentions in 2 weeks
No other project uses it yet
MicrosoftAGENTS.mdmicrosoft/agent-framework/python/packages/bedrock/AGENTS.md
Integration with AWS Bedrock for LLM inference.
Steady11 mentions in 2 weeks
No other project uses it yet
MicrosoftAGENTS.mdmicrosoft/agent-framework/python/packages/chatkit/AGENTS.md
Integration with OpenAI ChatKit (Python) for building chat UIs. ThreadItemConverter.structured_input_to_input() is an async override hook returning Message | list[Message] | None; to_agent_input() normalizes its output and preserves thread order. ThreadItemConverter.generated_image_to_input() is an async override hook returning Message | list[Message] | None; data URI media types are inferred by Content.from_uri().
Steady11 mentions in 2 weeks
No other project uses it yet
MicrosoftAGENTS.mdmicrosoft/agent-framework/python/packages/claude/AGENTS.md
Integration with Anthropic Claude as a managed agent (Claude Agent SDK). This package is for Claude's managed agent functionality. For basic Claude chat, use agent-framework-anthropic instead.
Steady11 mentions in 2 weeks
No other project uses it yet
MicrosoftAGENTS.mdmicrosoft/agent-framework/python/packages/copilotstudio/AGENTS.md
Integration with Microsoft Copilot Studio agents.
Steady11 mentions in 2 weeks
No other project uses it yet
MicrosoftAGENTS.mdmicrosoft/agent-framework/python/packages/declarative/AGENTS.md
YAML/JSON-based declarative agent and workflow definitions. Both state classes validate object attribute names but leave dictionary keys unchanged. DefaultHttpRequestHandler(max_response_body_bytes=...) defaults to a 10 MiB wire and decoded-stage body limit, including redirect and authentication responses. It supports identity, gzip, and deflate, rejects unsupported or incomplete encodings, and closes response streams without closing caller-owned clients. HTTPX is constrained to the 0.27 and 0.28 series; focused CI checks both series because response caching and default-header integration use its internals. DefaultMCPToolHandler creates a fresh…
Steady11 mentions in 2 weeks
No other project uses it yet
MicrosoftAGENTS.mdmicrosoft/agent-framework/python/packages/devui/AGENTS.md
Interactive developer UI for testing and debugging agents and workflows. Text content carrying additional_properties["core"]["model_output_kind"] == "refusal" is mapped to native Responses refusal parts and events; the legacy flat key remains readable. OpenAI input metadata uses the openai namespace while replay-critical writers retain documented legacy keys. Mapper aggregation, live rendering, and recovery state retain text/refusal boundaries by item and content index. DevUI is a development-only sample app, not a production hosting surface. Authentication is enabled by default. Unauthenticated mode is allowed…
Steady11 mentions in 2 weeks
No other project uses it yet
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.
