--- title: Microsoft releases Agent Skills for Python, a reusable... description: Microsoft has moved Agent Skills for Python from experimental to stable within its Agent Framework. The feature provides an open format for packaging domain... canonical: https://daily.dev/posts/microsoft-releases-agent-skills-for-python-a-reusable-packaging-format-for-ai-agents-dzsmgz4jt twitter:card: summary_large_image twitter:site: @dailydotdev og:type: website og:site_name: daily.dev og:title: Microsoft releases Agent Skills for Python, a reusable packaging format for AI agents | daily.dev og:description: Microsoft has moved Agent Skills for Python from experimental to stable within its Agent Framework. The feature provides an open format for packaging domain... og:url: https://daily.dev/posts/microsoft-releases-agent-skills-for-python-a-reusable-packaging-format-for-ai-agents-dzsmgz4jt og:image: https://api.daily.dev/og/posts/DzsMgZ4JT.png og:image:alt: Microsoft releases Agent Skills for Python, a reusable packaging format for AI agents og:image:width: 1200 og:image:height: 630 og:locale: en --- > ## Documentation Index > Fetch the complete documentation index at: https://daily.dev/llms.txt > Use this file to discover all available pages before exploring further. # Microsoft releases Agent Skills for Python, a reusable packaging format for AI agents **[Collections](https://daily.dev/sources/collections)** · 4 min read · 2 upvotes · 0 comments ## Summary Microsoft has moved Agent Skills for Python from experimental to stable within its Agent Framework. The feature provides an open format for packaging domain expertise — instructions, reference documents, and scripts — into reusable bundles that AI agents can load on demand. Three authoring styles are supported: file-based (SKILL.md directories), class-based (Python packages), and code-defined (inline). Enterprise governance features include human-in-the-loop approval gates, per-tenant skill filtering, and caching with per-key isolation. The release reflects Microsoft's broader bet that AI orchestration is becoming the primary abstraction layer in software development, potentially displacing traditional frameworks as core competencies. ## Content ## What Agent Skills actually is Microsoft recently shipped Agent Skills for Python as a stable, production-ready part of its agent framework. The core idea is straightforward: package reusable domain expertise — instructions, reference documents, scripts — into discrete bundles that agents can load on demand rather than stuffing everything into the context window upfront. The mechanism is called progressive disclosure. Agents see a skill's description first, load the full content only when relevant, and execute scripts only when needed. Four stages, each gated. This keeps context windows lean, which matters more than it might sound — a 2025 arxiv paper ("Is Progressive Disclosure All You Need for Long-Context Agents?") found that with a 20-book corpus, open-question accuracy jumped from 0.257 under raw navigation to 0.462 with a flat skill layout. On a single book, strong agents already searched well enough that skills added almost nothing. The takeaway: progressive disclosure helps most when the knowledge base is too large to browse efficiently, and a single routing layer beats deeper hierarchies. Three authoring styles are supported: - **File-based**: SKILL.md directories with YAML front matter - **Class-based**: Python packages - **Code-defined**: inline, for quick experimentation The recommended convention is storing skills under `.agents/skills/` for compatibility across tools. ## The governance layer This is where Agent Skills starts to look like something built for teams rather than solo tinkerers. The release includes: - Human-in-the-loop approval for skill loading and script execution - Filtering to expose curated skill subsets per agent or tenant - Caching with per-key isolation - An extensible source pipeline Teams can author skills independently and compose them into a single provider. That means consistent policy enforcement across agents without everyone reinventing the same guardrails. ## Why descriptions matter more than you'd expect A skill is only useful if the agent loads it at the right moment. The description is the selection mechanism — the agent reads it before deciding whether to pull the full content. Vague descriptions cause skills to be skipped or loaded when they shouldn't be. A good description specifies four things: the trigger scenario, the main capabilities, the expected output, and explicit boundaries. Something like: "Use this skill when reviewing Terraform PRs for Azure infrastructure. Do not use it for application code reviews." That last part — the negative boundary — is easy to skip and important to include. As skill libraries grow, overlapping descriptions create selection conflicts. Testing descriptions against real prompts, including cases where the skill should *not* load, is the only reliable way to validate the boundaries. ## How it fits alongside other tools Agent Skills isn't a standalone solution. Practitioners are using it as one layer in a broader stack alongside MCP servers and Arazzo workflows. A few patterns worth noting: **AGENTS.md as the entry point.** This is a separate open spec — essentially a README for coding agents — that gives project-specific orientation (setup, tools, test locations) in a single predictable file. Keep it under 150 lines, use it as an index rather than a data dump. Agent Skills extends this with task-specific SKILL.md files. **Auto-generation from OpenAPI specs.** Tools like Toolsmith can generate skills directly from OpenAPI specs, which makes the authoring overhead more manageable at scale. One practitioner indexed 1,489+ provider SKILL.md files this way. **Real-world example: Xcode disk cleanup.** One developer built an open-source Xcode Disk Cleanup Agent Skill that audits Derived Data, Simulators, archives, and caches before proposing any deletions. The skill uses a deterministic Python script to produce structured JSON output, keeping token usage low. Cleanup is approval-gated — nothing deleted without confirmation, and irreversible operations like Simulator removal require a second confirmation. It can also trigger automatically when an agent detects low storage during a build failure. This is a good illustration of the pattern: deterministic script, structured output, human approval before anything destructive. ## The broader context There's a reasonable argument that Agent Skills represents something more than a useful library feature. Every team has someone who carries the institutional knowledge of how things should be built — the right patterns, the edge cases, the things that burned everyone two years ago. That knowledge usually lives in one person's head and gets re-explained in every code review. Skills are a way to package that judgment and make it available to agents without the re-explanation. Whether that scales into something like a skills marketplace remains to be seen. Tools like Lola are aiming at unified skill distribution across agents, and the format is open enough that community sharing is plausible. For now, the practical value is narrower but real: repeatable workflows, consistent policy enforcement, and context windows that don't fill up with irrelevant instructions before the agent gets to the actual problem. ## Similar posts on daily.dev - [Agent Skills explained: Replacing AGENTS.md with reusable AI knowledge](https://daily.dev/posts/agent-skills-explained-replacing-agents-md-with-reusable-ai-knowledge-4lgrqdva9) · SwiftLee · 1 upvotes · 0 comments - [Agent Skills](https://daily.dev/posts/agent-skills-oiotdzetc) · Hacker News · 0 upvotes · 0 comments --- Tags: [#python](https://daily.dev/tags/python), [#microsoft](https://daily.dev/tags/microsoft), [#llm](https://daily.dev/tags/llm), [#ai-agents](https://daily.dev/tags/ai-agents) [View this post on daily.dev](https://daily.dev/posts/microsoft-releases-agent-skills-for-python-a-reusable-packaging-format-for-ai-agents-dzsmgz4jt) ```json {"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://daily.dev/#organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180},"sameAs":["https://twitter.com/dailydotdev","https://github.com/dailydotdev","https://www.linkedin.com/company/daily-dev-ltd"]},{"@type":"WebSite","@id":"https://daily.dev/#website","url":"https://daily.dev","name":"daily.dev","publisher":{"@id":"https://daily.dev/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://daily.dev/search?q={search_term_string}"},"query-input":"required name=search_term_string"}}]} {"@context":"https://schema.org","@type":"TechArticle","headline":"Microsoft releases Agent Skills for Python, a reusable packaging format for AI agents","url":"https://daily.dev/posts/microsoft-releases-agent-skills-for-python-a-reusable-packaging-format-for-ai-agents-dzsmgz4jt","mainEntityOfPage":{"@type":"WebPage","@id":"https://daily.dev/posts/microsoft-releases-agent-skills-for-python-a-reusable-packaging-format-for-ai-agents-dzsmgz4jt"},"datePublished":"2026-07-20T16:15:13.874Z","dateModified":"2026-07-27T08:37:11.744Z","description":"Microsoft has moved Agent Skills for Python from experimental to stable within its Agent Framework. The feature provides an open format for packaging domain...","image":"https://i.ytimg.com/vi/JhzKWtlCVW8/sddefault.jpg","thumbnailUrl":"https://i.ytimg.com/vi/JhzKWtlCVW8/sddefault.jpg","isAccessibleForFree":true,"articleSection":"Collections","inLanguage":"en","publisher":{"@type":"Organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180}},"author":{"@type":"Organization","name":"Collections","logo":"https://media.daily.dev/image/upload/s--fk_6ycEi--/f_auto,q_auto/v1780996001/logos/collections?_a=BAMAMiWQ0","url":"https://daily.dev/sources/collections"},"commentCount":0,"discussionUrl":"https://daily.dev/posts/microsoft-releases-agent-skills-for-python-a-reusable-packaging-format-for-ai-agents-dzsmgz4jt","interactionStatistic":[{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":2},{"@type":"InteractionCounter","interactionType":{"@type":"CommentAction"},"userInteractionCount":0}],"keywords":"python,microsoft,llm,ai-agents","timeRequired":"PT4M"} {"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://daily.dev"},{"@type":"ListItem","position":2,"name":"Collections","item":"https://daily.dev/sources/collections"},{"@type":"ListItem","position":3,"name":"Microsoft releases Agent Skills for Python, a reusable packaging format for AI agents"}]} ```