DEV Community

Cover image for Agent Skills moved to the Linux Foundation: 4 things SKILL.md authors should watch
Piekwerk
Piekwerk

Posted on

Agent Skills moved to the Linux Foundation: 4 things SKILL.md authors should watch

Yesterday Anthropic gave the Agent Skills standard away. The name, the logo, the GitHub organization, and the agentskills.io domain moved to the Agentic AI Foundation, the Linux Foundation body that already stewards the Model Context Protocol. If you write SKILL.md files, or you maintain agent configs that ship skills, this is more relevant than a press release about governance usually is. Nothing breaks today. But the roadmap attached to the handover touches the three things skill authors struggle with most: versions, security, and who decides what the format is.

What moved, and to whom

The Agentic AI Foundation (AAIF) is the Linux Foundation group Anthropic co-founded with Block and OpenAI, the same body that received MCP in December 2025. Anthropic's post describes the donation as the Agent Skills name and logo, the GitHub organization, and the agentskills.io domain.

Two details matter more than the asset list. First, you can keep using or contributing to the standard without joining the foundation, so the move adds an owner without adding an obligation. Second, maintenance is by named people, not corporate seats. David Soria Parra and Mahesh Murag are the lead maintainers, and engineers from Anthropic, Google, and OpenAI contribute as individuals.

The scale that made this worth doing

The numbers in the announcement: more than 70 agent platforms have integrated Agent Skills, including ChatGPT, Cursor, GitHub Copilot, and VS Code. One million skills have been published, with nearly 280 million installs.

The format has a short, fast history. Skills came out of the work on Claude Code, launched in October 2025. Within weeks, developers were publishing thousands of skills and writing loaders for Codex, Cursor, and OpenCode. The standard went public in December 2025, and ten months later it has a neutral owner. That is the same play that worked for MCP, executed faster.

What does not change today

The format itself is unchanged. A skill is still a folder with a SKILL.md file that teaches an agent a task or domain, plus any scripts and reference material it needs. Your installed skills keep working. There is no migration, no re-download, and nothing to opt into.

The honest read is that this announcement changes decision rights, not bytes. The trigger to act is not October 22, it is the first tagged spec release on agentskills.io. Here is what I am watching until then.

1. Versioned releases are coming, so prepare to pin

The proposed roadmap from Anthropic covers "versioned releases, a formal proposal process, and security guidance for people who write and install skills". The first item is the big one for anyone distributing skills.

Today, "my skill works" means "it works with whatever harness version the user happens to run". You cannot state a version requirement, because there is no spec version to require. Once releases are tagged, a skill can declare that it targets a specific spec version, the same way a lockfile pins a package. Before that day arrives, I am documenting which format behaviors each of my skills depends on, so the later diff is small and boring.

2. Security guidance is coming because skills can carry code

A skill can bundle executable scripts. That is the feature that makes skills powerful, and it is why the roadmap names security guidance for authors and installers as a work item.

You do not need to wait for the foundation to act on this. Reading a third-party skill before installing it takes minutes:

# before installing a third-party skill, read what it can run
find <skill-folder> -type f \( -name '*.sh' -o -name '*.py' -o -name '*.js' \) -exec head -50 {} \;
Enter fullscreen mode Exit fullscreen mode

If that file list comes back long, that is the finding. A skill that teaches a workflow should not need a small application to do it. I run this check on everything I install, and it has caught more than one script phoning home for "telemetry".

3. One foundation now governs the whole agent config stack

The skills donation was not even the whole story that day. At AGNTCon and MCPCon in San Jose, the AAIF also took in OpenAI's Open Responses, Hugging Face's OpenEnv, and Alibaba's OpenSandbox. That brought the foundation to 10 hosted projects, up from three in December 2025, sitting alongside MCP, AGENTS.md, and A2A.

Put that in config-file terms. The instruction file your agent reads, the skill folders it loads, and the tool protocol it speaks are now governed inside one organization. When a question crosses standards, such as how a skill should call an MCP tool, the answer can come from a shared table instead of three vendors' docs that disagree. If you have never felt that pain, I covered where the skills-versus-MCP line actually landed when the spec settled it. Cross-harness disagreement is where most of my config bugs live.

4. Descriptions do the routing, and that will survive any spec change

In every harness I use, the agent sees a skill's name and description before it decides to open the folder. The full instructions load only when a task matches. That progressive disclosure is the part of the format I would bet on surviving every future version, because it is the part that makes a hundred installed skills affordable in context.

So the description field is not documentation, it is routing. Write it for the agent doing the choosing:

---
name: pdf-invoice-extraction
description: "Extracts line items from scanned PDF invoices. Use when the user mentions invoices, receipts, or expense imports. Not for general PDF reading or generation."
---
Enter fullscreen mode Exit fullscreen mode

Name and domain, the trigger conditions, and one sentence on what NOT to use it for. That last part is underrated. Descriptions without negative scope get loaded for adjacent tasks, and a wrongly loaded skill costs you the tokens plus a confused detour.

My checklist while the roadmap is still a proposal

  • Document the format behaviors each of my skills depends on, while the list is still short.
  • Audit the scripts in every third-party skill before it goes anywhere near a repo with credentials.
  • Watch for the first tagged spec version and the proposal process, then pin skills to it the way I pin dependencies.
  • Re-read the security guidance when it lands, and expect it to formalize what careful authors already do.

Neutral ownership of a format that clearly won is good news for people who ship skills. The announcement asks nothing of you, which is exactly why it is a good moment to prepare for the parts that will. For a different flavor of "the ground moves under your agents", GitHub's Copilot default policy starts enforcing itself this month, and that one has a real deadline.

Top comments (0)