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/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
MicrosoftReads credentialsSkillmicrosoft/agent-framework/python/.github/skills/python-package-management/SKILL.md
Guide for managing packages in the Agent Framework Python monorepo, including creating new connector packages, versioning, and the lazy-loading pattern. Use this when adding, modifying, or releasing packages.
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
MicrosoftReads credentialsAGENTS.mdmicrosoft/agent-framework/python/packages/azure-ai-search/AGENTS.md
Integration with Azure AI Search for RAG (Retrieval-Augmented Generation) and vector storage. The package depends on azure-search-documents>=12.0.0,<13, which spans both channels, and auto-detects which build is installed — there is no api_version parameter: The provider never pins an api-version; the installed build picks its own default, so newer releases work without code changes (single source of truth = the install). Capability gating keys off _preview_agentic_features_available — whether the preview build's agentic symbols (KnowledgeRetrieval{Low,Medium}ReasoningEffort, KnowledgeRetrievalOutputMode) can be imported. Agentic output mode…
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
MicrosoftReads credentialsAGENTS.mdmicrosoft/agent-framework/python/packages/core/AGENTS.md
The foundation package containing all core abstractions, types, and built-in OpenAI/Azure OpenAI support. - agent_framework.__init__ uses lazy module-level __getattr__ for most public exports to keep cold import agent_framework lightweight. - Keep _LAZY_MODULE_EXPORTS, _LAZY_EXPORTS, the explicit runtime __all__, and __init__.pyi synchronized whenever adding, removing, or moving a root public export. - Runtime __all__ is still required for from agent_framework import *; the .pyi file is for type checkers and editors and does not replace runtime exports. - Public deprecation behavior for…
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.
