Deep dive

The Agent Skills standard: SKILL.md across Cowork, AI in SharePoint, Claude Code, and 6 other platforms

The same SKILL.md file now runs in nine AI tools. The Agent Skills open standard is quietly becoming the portable unit of AI workflow. What it means for your authoring strategy.

Daniel Anderson12 min read

The most important AI standard of 2025-2026 is one almost nobody is calling a standard. Agent Skills, the SKILL.md format Anthropic introduced for Claude Code in late 2025, now runs in nine AI tools across five vendors. It has become the portable unit of AI workflow. And almost no commentary has noticed.

This article is the long-form treatment. What the standard is, where it came from, the nine platforms that support it today, the practical implications for how you write AI workflows, and where the standard is heading.

If you read Cowork plugins explained for SharePoint AI Skills practitioners first, you have the applied context. This article zooms out to the format itself.

What Agent Skills actually is

Strip away the marketing and a Skill is simple: a Markdown file with YAML frontmatter, named SKILL.md.

---
name: meeting-prep
description: Use when user asks to prepare for an upcoming meeting. Pulls calendar context, recent email threads, and relevant documents into a briefing document.
---

You are preparing a meeting briefing for the user.

## Steps

1. Identify the meeting from the user's request (calendar entry or topic).
2. Pull the most recent five email threads with attendees.
3. Find any documents linked from the calendar invite or referenced in the threads.
4. Produce a one-page briefing with sections: meeting purpose, attendees, key context, suggested talking points.

## Output format

A Word document titled "Briefing: [meeting topic]" saved to the user's OneDrive in the Briefings folder.

That is it. Two required frontmatter fields (name, description), instructions in the Markdown body, optional reference materials in companion files alongside the SKILL.md.

The format is deliberately minimal. It does not specify a runtime. It does not require an SDK. It does not depend on a particular vendor's API. Anyone with a text editor can author one.

The minimalism is the point. By keeping the format slim and open, the same file becomes a portable artefact that runs anywhere a Skills-compatible runtime exists.

The nine platforms that support it today

Microsoft's Cowork plugin documentation lists nine platforms as fully compatible with the Agent Skills standard.

PlatformVendorNotes
Microsoft 365 Copilot CoworkMicrosoftUsed as plugin skills and as user-level custom skills in OneDrive
AI in SharePointMicrosoftSite-scoped skills at /Agent Assets/Skills/<name>/SKILL.md
Claude CodeAnthropicOrigin of the format. Plugin-level and project-level skills
Claude.ai ProjectsAnthropicSkills uploadable as project files
Visual Studio Code CopilotMicrosoftAgent Skills supported in agent mode
Gemini CLIGoogleAgent Skills supported
JetBrains JunieJetBrainsAgent Skills supported
OpenAI CodexOpenAIAgent Skills supported
CursorAnysphereAgent Skills supported

Five vendors. Nine products. One file format.

This is broader adoption than most industry-standard AI formats achieve. Compare to the Model Context Protocol (MCP), another open standard that has become widely adopted. Or to function calling formats, where each vendor has its own conventions despite years of convergence pressure. Agent Skills has converged faster than either.

The reason is partly that the format is simple. Markdown plus YAML is universal. The barrier to adoption is essentially zero for any vendor that wants to support reusable workflows.

The other reason is that the format separates intent from runtime. A SKILL.md describes what the workflow should do. The runtime decides what the workflow can actually do. Vendors can adopt the format without committing to compatibility on capabilities.

Where it came from

Anthropic introduced the Skills concept in late 2025 as part of Claude Code's plugin architecture. The original use case was developer productivity: a structured way to give Claude Code repeatable instructions for things like running tests, formatting code, or generating boilerplate.

Microsoft adopted the format for AI in SharePoint when the Knowledge Agent shipped in preview (later renamed AI in SharePoint). Site owners author SKILL.md files at /Agent Assets/Skills/<name>/SKILL.md and they get loaded into Cowork-style runtime in the SharePoint context.

Cowork itself launched in March 2026 with built-in skills using the same format, plus support for user-authored custom skills in OneDrive. The May 2026 plugin announcement added the packaging layer (M365 App Packages wrapping SKILL.md files for tenant-level distribution).

Google, OpenAI, JetBrains, and Cursor each adopted the format for their own agent products through 2025 and early 2026. None of them announced "we are adopting Anthropic's standard" with fanfare. The format simply showed up in their docs as the way to write reusable workflows.

The pattern is similar to how Markdown itself became a standard. No formal committee. No vendor-driven blessing. The format was simple enough and useful enough that adoption became the path of least resistance.

What portability actually means

The promise of a cross-platform standard is "write once, run anywhere". The reality of Agent Skills is "write once, adapt lightly per target".

A SKILL.md file is parseable in any of the nine platforms. The frontmatter and the body are read the same way. The format itself is truly portable.

What is not always portable: the steps inside the body. A SKILL.md that calls an external API works in Claude Code (which can run shell commands and HTTP requests) but not in AI in SharePoint (which has no external system access). A SKILL.md that creates a Word document works in Cowork (which has the Word skill loaded) but does not work in Cursor (which is a code editor).

The practical pattern: write the SKILL.md for the most capable target, then maintain per-target variants where the runtime constrains the steps.

TargetRuntime capabilitiesBest fit for
Claude CodeShell, HTTP, file system, MCP serversDeveloper workflows, build scripts, repository operations
CoworkM365 surface (Outlook, Teams, Word, Excel, OneDrive, calendar, search) plus connector pluginsKnowledge work spanning multiple M365 apps
AI in SharePointOne SharePoint site's content (libraries, lists, pages)Site-scoped, team-shared workflows
Copilot Studio agentCross-system via connectors, Power Automate flowsCross-platform, action-taking, multi-channel
VS Code CopilotEditor file system, integrated terminalEditor-bound workflows, code generation
Gemini CLIGoogle ecosystem plus shellGoogle Workspace and CLI workflows

The same workflow intent (e.g. "produce a weekly project report") gets implemented differently per target. The SKILL.md in each version describes the same goal; the steps are written for the runtime.

For most authoring teams, the right pattern is one canonical SKILL.md per workflow plus per-target editing. Three SKILL.md files for three runtimes is fine. A 30-line abstraction layer is not. Skills are meant to be readable; over-engineering them defeats the purpose.

What this means for SharePoint AI Skills practitioners

Three implications worth naming.

One: every SharePoint AI Skill is potentially nine-platform deployable. The Markdown file you have already written is in the standard format. Where it deploys depends on the work, not on the file. A site-scoped policy lookup stays a SharePoint AI Skill. A workflow that spans calendar, email, and documents becomes a Cowork plugin. A developer-facing version of the same intent could become a Claude Code plugin.

Two: the investment in writing good SKILL.md files compounds. Time spent making a workflow clear, well-described, and well-structured pays back across multiple platforms rather than locking you into one vendor's tooling. This is a different return profile from investing in a vendor-specific equivalent (like a Power Automate flow or a Copilot Studio topic). The vendor-specific options are deeper but locked in. SKILL.md is shallower but portable.

Three: the authoring discipline matters more than the platform choice. What makes a SKILL.md work well is the same on every platform: a clear description that includes trigger phrases, instructions that read like a runbook, examples that show the desired output, edge case handling. Get the authoring discipline right and your skill works well everywhere. Get the description vague and the skill is unreliable on every platform.

The companion how-to is in how to ship your SharePoint AI Skill as a Cowork plugin. The runtime comparison across surfaces is in Cowork Skills and SharePoint AI Skills.

What Microsoft's adoption tells you about the trajectory

Microsoft's commitment to Agent Skills is now structural, not experimental.

Three signals.

Cowork built on the standard. Cowork's 13 built-in skills are SKILL.md files. Custom user skills are SKILL.md files. Plugin skills are SKILL.md files. The standard is the foundation of Cowork's architecture, not an optional extension.

AI in SharePoint built on the standard. When Microsoft renamed Knowledge Agent to AI in SharePoint and rebuilt the runtime on Anthropic's Claude, the SKILL.md format stayed. The site-scoped Skill format that SharePoint AI Skills use is the same Agent Skills format.

The conversion script ships. Microsoft built and documented Convert-ClaudePluginToMOS3.ps1 specifically to take Claude Code plugins (which use the standard) and turn them into M365 App Packages. The script's existence signals that Microsoft expects developers to author in the open standard first and target M365 second.

For an enterprise vendor, that level of commitment to a standard originally introduced by a competitor is unusual. It signals confidence that the format is durable enough to bet on.

What the limits of the standard look like

Three limits worth knowing before you over-invest in portability.

Runtime capability differences are real. A skill that uses Power BI in Cowork does not work in Claude Code without the Power BI MCP server. A skill that organises files on disk in Claude Code does not work in AI in SharePoint. Plan for per-target adaptation; do not assume zero editing.

Companion file conventions vary. All nine platforms accept reference material alongside SKILL.md, but the supported file types and size limits differ. Microsoft's Cowork allows 20 companion files, 5 MB each, 10 MB total per skill. Claude Code allows different limits. Build skills with light dependencies and they port more easily.

Vendor-specific extensions are starting to appear. Microsoft has added cowork.category and cowork.icon to its SKILL.md frontmatter. These are valid Agent Skills frontmatter (the standard allows arbitrary fields) but they only do anything in Cowork. Other vendors will likely add their own extensions. The base format stays portable; specific extensions are platform-specific.

The pattern looks like Markdown's evolution. A stable core that runs everywhere, plus optional vendor extensions that activate features on specific platforms. The discipline is to write the core SKILL.md cleanly and use extensions sparingly.

What good authoring looks like in 2026

Three principles that hold across all nine platforms.

Write descriptions like trigger phrases. "Use when the user asks for a meeting briefing" beats "Helps with meetings". The description is what the runtime uses to decide whether to load your skill. Specific is better than aspirational.

Keep SKILL.md focused, push details to companion files. A 1,500-2,000 word SKILL.md is the sweet spot. Longer skills are harder for the runtime to load and harder for humans to maintain. Move detailed reference content to a references/ subfolder.

Test on the runtime, not in the abstract. A SKILL.md that reads well does not always perform well. Run it on the target platform with realistic inputs and edit based on actual outputs. Five rounds of test-and-edit beats five rounds of authoring without testing.

These principles do not depend on which platform you are targeting. They are properties of well-authored Skills, full stop.

Where the standard is heading

Three predictions worth sharing, with the caveat that all predictions about AI in 2026 should be held loosely.

Wider vendor adoption. Several smaller AI tools have not yet adopted Agent Skills. Most will, because the cost of supporting it is near zero and the benefit (their users can bring existing skills) is real.

Tighter integration with MCP. Skills describe intent. MCP describes capability. The two are increasingly bundled in plugin packages (Microsoft's Cowork plugin format is the clearest example). Expect more vendors to ship combined Skills + MCP packaging.

More vendor-specific frontmatter extensions. Microsoft has started; others will follow. The base format will stay stable. The optional extensions will activate platform-specific features. As long as the extensions are optional, portability survives.

The longer-term trajectory is that Skills become the lingua franca for AI workflow description across the industry. Not because anyone declared it the standard, but because the format works, adoption is broad, and the economics favour authoring once over authoring per vendor.

For SharePoint AI Skills practitioners, the implication is simple: you are already writing in the format that runs everywhere. Keep writing. Pick the platform per workload. Let the portability work in your favour.

Get the first wave of Skills when the directory opens.

Production-ready Skill Markdown files, tested in real client tenants. Free for the first wave of subscribers.

Frequently asked questions

Answers to the questions we hear most

What is the Agent Skills standard?

Agent Skills is an open standard for describing reusable AI workflows in a Markdown file (SKILL.md) with YAML frontmatter. The frontmatter declares name and description; the Markdown body contains the workflow instructions. It is the same format originally introduced by Anthropic for Claude Code and now adopted by Microsoft, Google, JetBrains, OpenAI, and others.

Which AI tools support the Agent Skills standard?

As of May 2026, full compatibility is documented for nine tools: Microsoft 365 Copilot Cowork, AI in SharePoint, Claude Code, Claude.ai Projects, Visual Studio Code Copilot (in agent mode), Gemini CLI, JetBrains Junie, OpenAI Codex, and Cursor. Microsoft's Cowork plugin documentation lists this set explicitly.

Can the same SKILL.md file run in all nine platforms unchanged?

The format is identical, so the file is parseable everywhere. The runtime capabilities each platform exposes are different, so a SKILL.md may need light editing per target to drop steps the runtime cannot perform. Workflow intent is portable; specific actions are not always portable.

Where did the Agent Skills standard come from?

Anthropic introduced Skills as part of Claude's agent capabilities in late 2025. The format was deliberately open: a Markdown file with YAML frontmatter, a clear separation of workflow intent from runtime details. Microsoft adopted the same format for AI in SharePoint, then for Cowork. Other vendors followed when their own agent products needed a portable workflow unit.

Does this mean Skills are now an industry standard?

In practice, yes. Nine AI vendors have adopted the same file format. There is no formal standards body governing it, but the de facto adoption is broad enough that most authoring teams treat it as the format. The closest analogy is JSON or Markdown itself: not blessed by a committee, but used universally enough that it acts as a standard.

How does Skills compare to MCP (Model Context Protocol)?

Different layers. Skills describe workflow intent in natural language. MCP describes how an AI tool talks to external systems (data sources, APIs, tools). A SKILL.md and an MCP server often work together: the Skill describes the workflow, the MCP server provides the runtime tools. Microsoft's Cowork plugin format wraps both: SKILL.md files for intent, MCP server connectors for capability.

What does Agent Skills mean for SharePoint AI Skills?

SharePoint AI Skills are an instance of the Agent Skills standard, scoped to a SharePoint site. The same SKILL.md you write for a SharePoint site can become a Cowork plugin (with a manifest wrapper), a Claude Code plugin, or be uploaded as a Claude.ai project file. The format is portable; the deployment target changes.

Should organisations standardise on writing SKILL.md files for all AI workflow work?

For workflows that need to be reusable across multiple AI tools or surfaces, yes. SKILL.md is now portable across nine platforms and that count is growing. For one-off workflows tied to a single tool, the standard adds overhead without payoff. The rule of thumb: if more than one team or more than one tool will use the workflow, write it as SKILL.md.

What are the limits of the Agent Skills standard?

Runtime capabilities differ between platforms. A skill that calls an external API in Claude Code may not work in AI in SharePoint, which has no external system access. Companion file conventions vary slightly between platforms. Authentication models are platform-specific. The standard covers the workflow description format, not the runtime contract. Treat it as authoring portability, not deployment portability.

Where is the Agent Skills standard heading?

Anthropic, Microsoft, and other vendors are continuing to add fields and conventions. Microsoft's Cowork extends the base format with Cowork-specific frontmatter fields (cowork.category, cowork.icon). Other vendors are likely to do the same. The base format will stay portable; vendor-specific extensions will be optional. The trajectory looks similar to Markdown: a stable core with optional extensions.

Daniel Anderson

Founder, ShiftF5.ai · Microsoft Partner

Microsoft 365 consultant with twenty years in SharePoint, Copilot, and M365 AI enablement. Publisher of sharepointaiskills.com. I write about what actually ships in client tenants.

Connect on LinkedIn →