microsoft/agent-framework
6 skills284 installs74.7k starsGitHub
Install
npx skills add https://github.com/microsoft/agent-frameworkSkills in this repo
1Python Code QualityMicrosoft Agent Framework Python code quality skill. Defines linting, typing, formatting, and review standards for Python code in the agent framework repository. Guides contributors on ruff or pylint conventions, type hint requirements, test coverage expectations, and PR review checklist items specific to agent framework Python modules. Ensures consistent code quality across agent orchestration, tool definitions, and framework extension code.94installs2Python DevelopmentThe python-development skill defines coding standards for Python source in the Microsoft Agent Framework repository. Every .py file must begin with the Microsoft copyright header, and public APIs require Google-style docstrings with Args, Returns, Raises, and Keyword Args sections for framework-specific exceptions. Type annotations mandate return and parameter types, prefer Type | None over Optional, use from __future__ import annotations, and favor Mapping over MutableMapping for read-only inputs. Function design limits positional parameters to three, pushes optional args after a keyword-only star, and discourages **kwargs except for subclass extensibility. Package __init__.py files re-export public APIs with explicit __all__ and direct imports, avoiding identity aliases and star imports. Import structure groups core agent_framework symbols, observability components, and lazy-loaded connectors such as OpenAI and Foundry clients. Performance guidance caches expensive work like JSON schema generation, prefers match on .type in hot paths, and assumes async by default. Use when writing or modifying Python files under the Agent Framework python/ tree.57installs3Build And TestThe build-and-test skill documents how to build and test .NET projects in the Microsoft Agent Framework repository. Only UnitTest projects run locally because IntegrationTests require external dependencies. Commands from the dotnet directory include dotnet restore, build with --tl:off to avoid agent flicker, dotnet test, and dotnet format. Isolated changes should build only the affected project and its UnitTests before full solution validation, while public API changes require immediate full solution build and all unit tests. Single test execution uses filter-query with assembly namespace class method wildcards and --ignore-exit-code 8 when MTP reports no matching tests. Multi-target framework tip passes -f net10.0 when code lacks framework-specific if directives. Package restore tip adds --no-restore after initial restore for faster builds. Linux runs only .NET Core tests via net10.0 framework filter. Microsoft Testing Platform via xUnit v3 requires --project on dotnet test, supports coverage with cobertura output, and filtered solutions via New-FilteredSolution.ps1. Use when verifying or testing Agent Framework changes.41installs4Python Package ManagementThe python-package-management skill guides package management in the Microsoft Agent Framework Python monorepo. The layout places agent-framework-core under packages/core with provider connector packages alongside, and the root agent-framework meta-package depending on agent-framework-core all. Dependency management uses uv and poethepoet tasks including setup, install, venv, validate-dependency-bounds-test, validate-dependency-bounds-project, add-dependency-and-validate-bounds, and upgrade-dev-dependencies. Bound rules require stable deps as greater-than-known-good less-than-next-major, hard caps for prerelease and sub-1.0 packages, and workspace-wide gates before per-package bound expansion. Provider folders in core use __getattr__ lazy loading that imports connector packages on demand with install hints on ModuleNotFoundError. New connector packages start as alpha with dated 1.0.0a versions, samples inside the package, no all extra inclusion, and no core lazy loading until promoted. Updates require PACKAGE_STATUS.md maintenance and core team approval before creating packages. Use when adding, modifying, releasing, or validating Agent Framework Python connector packages.34installs5Python TestingThe python-testing skill defines how to create, modify, and run tests across Agent Framework Python packages. Coverage targets at least 85 percent with PR unit-only runs excluding integration via -m not integration and full integration on merge. Tests use asyncio_mode auto without pytest.mark.asyncio, 60 second timeouts, importlib isolation, and pytest-xdist parallelization on large packages. Directory rules forbid __init__.py in test folders and require unique subdirectories for non-core packages. Integration tests need flaky, integration, and skip_if decorators together. Commands include uv run poe test with -P, -A, -C, and direct package execution. Use when adding or updating Agent Framework Python tests.32installs6Project StructureThe project-structure skill maps dotnet/src packages including Microsoft.Agents.AI, Abstractions, providers, Workflows, samples, and tests with UnitTests and IntegrationTests naming plus Shared and LegacySupport includes.26installs