SKILL.md
$27
- Read the Microsoft Agent Framework overview first: https://learn.microsoft.com/agent-framework/overview/agent-framework-overview
- Prefer official docs and samples for the current API surface.
- Use the Microsoft Docs MCP tooling when available to fetch up-to-date framework guidance and examples.
- Treat older Semantic Kernel or AutoGen patterns as migration inputs, not as the default implementation model.
Shared guidance
When working with Microsoft Agent Framework in any language:
- Use async patterns for agent and workflow operations.
- Implement explicit error handling and logging.
- Prefer strong typing, clear interfaces, and maintainable composition patterns.
- Use
DefaultAzureCredentialwhen Azure authentication is appropriate.
- Use agents for autonomous decision-making, ad hoc planning, conversation flows, tool usage, and MCP server interactions.
- Use workflows for multi-step orchestration, predefined execution graphs, long-running tasks, and human-in-the-loop scenarios.
- Support model providers such as Azure AI Foundry, Azure OpenAI, OpenAI, and others, but prefer Azure AI Foundry services for new projects when that matches user needs.
- Use thread-based or equivalent state handling, context providers, middleware, checkpointing, routing, and orchestration patterns when they fit the problem.
Migration guidance
- If migrating from Semantic Kernel, use the official migration guide: https://learn.microsoft.com/agent-framework/migration-guide/from-semantic-kernel/
- If migrating from AutoGen, use the official migration guide: https://learn.microsoft.com/agent-framework/migration-guide/from-autogen/
- Preserve behavior first, then adopt native Agent Framework patterns incrementally.
Workflow
- Determine the target language and read the matching reference file.
- Fetch the latest official docs and samples before making implementation choices.
- Apply the shared agent and workflow guidance from this skill.
- Use the language-specific package, repository, sample paths, and coding practices from the chosen reference.
- When examples in the repo differ from current docs, explain the difference and follow the current supported pattern.
References
Completion criteria
- Recommendations match the target language.
- Package names, repository paths, and sample locations match the selected ecosystem.
- Guidance reflects current Microsoft Agent Framework documentation rather than legacy assumptions.
- Migration advice calls out Semantic Kernel and AutoGen only when relevant.