Ein SKILL.md für alle Agenten: Agent Skills wird herstellerneutraler Standard der Linux Foundation
Seit dem 22. Oktober 2026 ist Agent Skills ein vendor-neutraler Standard unter dem Dach der Linux Foundation, den bereits über 70 Plattformen unterstützt haben. Ein Skill funktioniert demnach plattformübergreifend, wenn er nur die Felder der Spec im Frontmatter nutzt und im gemeinsamen Ordner .agents/skills liegt.
Veröffentlicht am 25. Oktober • Zuerst erschienen auf promptstaging.site
Kurze Antwort: Ja, eine SKILL.md kann agentenübergreifend laufen. Seit dem 22. Oktober 2026 ist Agent Skills ein herstellerneutraler Standard unter dem Dach der Linux Foundation, der bereits von über 70 Plattformen übernommen wurde. Ein Skill funktioniert überall, wenn er (1) nur die Frontmatter-Felder der Spezifikation verwendet, (2) im gemeinsamen Ordner.agents/skills liegt und (3) in den eigenen Ordner jedes Agenten kopiert oder verlinkt wird. Nachfolgend: die vollständige Ordnerübersicht, die Portabilitätsregeln und ein komplettes, getestetes Beispiel zum Kopieren.
Am 22. Oktober 2026 hat Anthropic die Agent-Skills-Spezifikation, also den Namen, das Format, die GitHub-Organisation und die Referenzseite agentskills.io, an die Agentic AI Foundation (AAIF) übergeben, das Zuhause der Linux Foundation für agentische Standards. Am selben Tag nahm die AAIF auch OpenAIs Open Responses, Hugging Faces OpenEnv und Alibabis OpenSandbox auf und wuchs damit von 3 auf 10 gehostete Projekte.
Warum das für Sie wichtig ist: Die Übergabe beseitigt den letzten Grund zu zögern. Agent Skills ist nicht länger „ein Claude-Feature, das andere Tools kopiert haben“, sondern der gemeinsame Standard, mit über 70 integrierten Plattformen, mehr als 1 Million veröffentlichten Skills und rund 280 Millionen gemeldeten Installationen zum Zeitpunkt der Übergabe.
Die Verantwortung liegt bei der AAIF, aber im Tagesgeschäft wird der Standard von Ingenieuren gepflegt, die als Einzelpersonen für Anthropic, Google, OpenAI und andere Unternehmen tätig sind; David Soria Parra und Mahesh Murag werden als leitende Maintainer genannt. Anthropic hat eine erste Roadmap vorgeschlagen: versionierte Releases, einen formellen Prozess für Änderungsvorschläge und veröffentlichte Sicherheitsleitlinien für Menschen, die Skills schreiben und installieren. Dieser letzte Punkt ist das offizielle Eingeständnis des Vertrauensproblems: Mit rund 1 Million veröffentlichten Skills und etwa 280 Millionen Installationen darf Installationssicherheit nicht länger Stammeswissen sein. (Die Übergabe wurde am 22.
Oktober auf der AGNTCon + MCPCon North America in San Jose angekündigt; Agent Skills war eines von vier neuen AAIF-Projekten und Anthropics zweite Spende an die Stiftung nach MCP.)
Die Governance des Formats ist gewandert, das Eigentum an Ihren Skills nicht. Ein Skill, den Sie schreiben, bleibt Ihre Datei, in Ihrem Repository, unter Ihrer Lizenz. Sie brauchen keine AAIF-Mitgliedschaft, kein bezahltes Konto und die Erlaubnis niemandes, um einen zu veröffentlichen.
Die Spezifikation ist geteilt, die Ordner nicht. Claude Code, Codex, Cursor, Copilot und Gemini CLI durchsuchen jeweils ihre eigenen Verzeichnisse. Portabilität ist daher ein Problem der Dateiorganisation, und es ist vollständig lösbar, was der Rest dieses Leitfadens zeigt.
Ein Agent Skill ist ein Ordner mit einer SKILL.md-Datei: YAML-Frontmatter (name und description sind Pflichtfelder) plus Anleitungen in natürlicher Sprache, optional mit den Unterordnern scripts/, references/ und assets/ für unterstützende Dateien.
Der Mechanismus, der Skills günstig macht, ist progressive disclosure: Beim Start liest ein Agent nur Name und Beschreibung jedes Skills, also wenige Dutzend Tokens. Die vollständigen Anweisungen werden erst geladen, wenn Ihre Anfrage zur Beschreibung passt. Zwei Konsequenzen:
Legen Sie eine kanonische Kopie im gemeinsamen Ordner.agents/skills ab, dem Ort, auf den der Standard verweist und den mehrere Agenten bereits direkt lesen, und verlinken oder kopieren Sie sie dann in die Ordner, die die anderen durchsuchen:
Die Pfade folgen der aktuellen Dokumentation der jeweiligen Hersteller. Prüfen Sie die Dokumentationsseite Ihres Agenten, da sich die Anbieter auf.agents/skills zubewegen und ältere pro-Tool-Ordner als Kompatibilitätsaliase erhalten bleiben.
Jede Aufgabe, für die Sie mindestens zweimal einen wiederverwendbaren Prompt geschrieben haben, kann ein Skill werden. Beginnen Sie mit einem Prompt, der bereits funktioniert. Falls Sie einen brauchen, entwerfen Sie ihn zuerst im Prompt Generator und wandeln Sie ihn dann um.
Die Spezifikation definiert eine kleine Menge von Feldern, die jeder Agent versteht. Toolspezifische Zusatzfelder werden von manchen Agenten ignoriert und von manchen Upload-Prozessen outright abgelehnt (der claude.ai-Skill-Upload ist streng), halten Sie daher die gemeinsame Datei auf Spezifikationsfelder und legen Sie Tool-Extras in Kopien pro Tool oder Metadaten ab.
Strukturieren Sie den Hauptteil so: Wann verwenden (und wann nicht), nummerierte Schritte, genaues Ausgabeformat, Grenzfälle. Halten Sie den Hauptteil unter 500 Zeilen bzw. rund 5.000 Tokens; lange Referenzmaterialien gehören in references/-Dateien, die der Agent nur bei Bedarf öffnet.
Deterministische Schritte (Datumsberechnungen, Dateiumbenennung, Formatkonvertierung) gehören in scripts/. Beurteilungsschritte gehören in Fließtext. Jedes zusätzliche Skript ist auch Angriffsfläche, siehe den Sicherheitscheck unten.
Ein vollständiger Skill ohne Programmierung: das Verfolgen unbezahlter Rechnungen, die Art von Aufgabe, die Fachleute wöchentlich wiederholen:
--- name: invoice-chaser description: Draft a polite-but-firm payment reminder for an overdue invoice. Use when the user mentions an unpaid, overdue, or late invoice, a client who hasn't paid, or asks for a payment follow-up email. Not for quotes, receipts, or first invoices. license: MIT metadata: author: PromptStaging version: 1.0 --- # Invoice Chaser ## When to use - An invoice is past its due date and the user wants a reminder drafted. - Do NOT use for issuing a first invoice, quotes, or payment receipts. ## Steps 1.
Nachfragen oder extrahieren: Rechnungsnummer, Kundenname, Betrag plus Währung, Fälligkeitsdatum, Tage überfällig. 2. Ton anhand der überfälligen Tage wählen: 1 bis 7 Tage = freundlicher Hinweis; 8 bis 21 = bestimmt, Bedingungen wiederholen; 22+ = letzte Mahnung, nächsten Schritt nennen.
3. Die E-Mail entwerfen: Betreff `Payment reminder: Invoice #[number] — [amount]`, Haupttext unter 120 Wörtern, Betrag, Fälligkeitsdatum und ein klares Zahlungsziel 7 Tage in der Zukunft enthalten. 4.
Mit einer Zeile enden: was sich ändert, wenn sie nicht zahlen (Säumnisgebühr / Arbeitsstopp), und nur, wenn der Nutzer bestätigt, dass eine der Optionen zutrifft. 5. NUR die E-Mail ausgeben (Betreff plus Haupttext), es sei denn, der Nutzer bittet um Erläuterung.
In den Vollbildmodus wechseln Vollbildmodus beenden. Bauen Sie dies im Skill Builder, führen Sie es dann durch den Quality Check Builder, bevor Sie es irgendwo installieren.
Führen Sie fünf neue Prompts in jedem Agenten aus: drei, die den Skill auslösen sollten (jedes Mal anders formuliert, formell, locker, mit Tippfehlern), und zwei, die ihn nicht auslösen sollten (angrenzende Aufgaben: eine Angebotsanfrage, eine Quittung). Bewertung: 3/3 Auslösungen plus 0/2 Fehlauslösungen bedeutet: veröffentlichen. Wenn er zu selten auslöst, ist die Beschreibung zu eng; ergänzen Sie die fehlenden Formulierungen. Wenn er zu oft auslöst, fügen Sie explizite „nicht für…“-Fälle hinzu.
Die Skripte eines Skills werden mit Ihren Zugangsdaten ausgeführt. Bevor Sie den Skill einer anderen Person installieren: Lesen Sie die SKILL.md vollständig, lesen Sie jedes Skript und installieren Sie nur aus Quellen, denen Sie Code anvertrauen würden, denn das ist es buchstäblich. Pinne Sie eine Version fest; lesen Sie bei Updates erneut.
Neu seit September 2026: MCPs SEP-2640-Erweiterung erlaubt einem MCP-Server, Skills neben seinen Tools zu veröffentlichen. Die Schichten konvergieren, sie konkurrieren nicht. Wenn Sie den Capability-Teil brauchen, bauen Sie ihn im MCP Studio.
Funktioniert ein Skill in Claude Code, Codex und Cursor? Ja, das Agent-Skills-Format ist ein gemeinsamer Standard, und alle drei lesen SKILL.md-Dateien. Unterschiedlich ist lediglich der Ordner, den jeder durchsucht; behalten Sie die Hauptdatei in.agents/skills und verlinken oder kopieren Sie sie in den Ordner jedes Agenten (Übersicht oben).
Wo lege ich SKILL.md-Dateien ab? In einem Ordner, der exakt nach dem Skill benannt ist, innerhalb eines skills-Verzeichnisses:.agents/skills/<name>/SKILL.md für den gemeinsamen Standardspeicherort,.claude/skills/<name>/SKILL.md für Claude Code,.github/skills/<name>/SKILL.md für Copilot-Projekte; persönliche Skills liegen in den entsprechenden Ordnern unter Ihrem Home-Verzeichnis.
Wie lang sollte eine SKILL.md sein? Halten Sie den Hauptteil unter 500 Zeilen (etwa 5.000 Tokens). Längeres Material gehört in references/-Dateien innerhalb des Skill-Ordners, die der Agent nur öffnet, wenn die Aufgabe sie benötigt.
Muss ich programmieren können, um einen Skill zu schreiben? Nein. Ein Skill ist eine Markdown-Datei mit einem kleinen YAML-Kopf. Skripte sind optional und nur sinnvoll, wenn ein Schritt genau eine richtige Antwort hat. Das Beispiel invoice-chaser oben besteht nur aus Fließtext.
Ist SKILL.md dasselbe wie AGENTS.md? Nein. AGENTS.md enthält immer aktive Projektregeln und wird in jeder Sitzung geladen. Eine SKILL.md wird nur geladen, wenn eine Anfrage zu ihrer Beschreibung passt; es ist bedarfsgesteuertes Wissen, keine dauerhaften Regeln. Die meisten Setups nutzen beides.
Sind Claude Skills und Agent Skills dasselbe? Agent Skills ist der offene Standard, den Anthropic geschaffen und im Oktober 2026 an die Agentic AI Foundation der Linux Foundation übergeben hat. „Claude Skills“ ist Anthropics Implementierung desselben Standards innerhalb der Claude-Produkte; Skills, die nach dem Standard geschrieben sind, funktionieren auch in anderen Agenten.
Nehmen Sie einen Prompt, den Sie wöchentlich wiederverwenden, und machen Sie daraus einen Skill: Entwerfen Sie ihn im Skill Builder, prüfen Sie ihn mit dem 5-Prompt-Trigger-Test und installieren Sie ihn aus einem einzigen Hauptordner. Sie möchten fertige Ausgangspunkte? Das Skills Directory sammelt produktionsreife Skills, darunter Release Notes für Entwickler sowie Listing-, Rechnungs- und HR-Skills für Fachleute, die Sie kopieren, anpassen und durch denselben Test schicken können, bevor sie auch nur in die Nähe Ihrer Agenten gelangen.
Automatisch übersetzt. Das Original auf Englisch ist unten aufklappbar.
Original (Englisch) anzeigen
Posted on Oct 25 • Originally published at promptstaging.site
Quick Answer: Yes — one SKILL.md can run across agents. Since 22 October 2026, Agent Skills is a vendor-neutral standard under the Linux Foundation, already adopted by 70+ platforms. A skill works everywhere if it (1) uses only the spec's frontmatter fields, (2) lives in the shared.agents/skills folder, and (3) is copied or linked into each agent's own folder. Below: the full folder map, the portability rules, and a complete tested example you can copy.
On 22 October 2026, Anthropic donated the Agent Skills specification — the name, the format, the GitHub organisation and the agentskills.io reference site — to the Agentic AI Foundation (AAIF), the Linux Foundation's home for agentic standards. The same day, AAIF also took in OpenAI's Open Responses, Hugging Face's OpenEnv and Alibaba's OpenSandbox, growing from 3 to 10 hosted projects.
Why it matters to you: the donation removes the last reason to hesitate. Agent Skills is no longer "a Claude feature other tools copied" — it is the shared standard, with 70+ platforms integrated, over 1 million skills published and roughly 280 million installs reported at the handover.
Stewardship sits with the AAIF, but day-to-day the standard is maintained by engineers from Anthropic, Google, OpenAI and other companies acting as individuals — David Soria Parra and Mahesh Murag are named as the lead maintainers. Anthropic has proposed a starting roadmap: versioned releases, a formal process for proposing changes, and published security guidance for people who write and install skills. That last item is the official acknowledgement of the trust problem: with roughly 1 million skills published and ~280 million installs, install-time safety can no longer be tribal knowledge. (The handover was announced on 22 October at AGNTCon + MCPCon North America in San Jose — Agent Skills was one of four new AAIF projects, and Anthropic's second donation to the foundation after MCP.)
Governance of the format moved; ownership of your skills did not. A skill you write remains your file, in your repo, under your licence. You do not need an AAIF membership, a paid account, or anyone's permission to publish one.
The spec is shared; the folders are not. Claude Code, Codex, Cursor, Copilot and Gemini CLI each scan their own directories. Portability is therefore a file-organisation problem — and it is fully solvable, which is the rest of this guide.
An Agent Skill is a folder containing a SKILL.md file: YAML frontmatter ( name and description are required) plus plain-language instructions, optionally with scripts/, references/ and assets/ subfolders for supporting files.
The mechanism that makes skills cheap is progressive disclosure: at startup, an agent reads only each skill's name and description — a few dozen tokens. The full instructions load only when your request matches the description. Two consequences:
Source one canonical copy in the shared.agents/skills folder — the location the standard points at and several agents already read directly — then link or copy it into the folders the others scan:
Paths follow each vendor's current documentation — check your agent's docs page, as vendors are converging on.agents/skills and older per-tool folders are being kept as compatibility aliases.
Any task you have written a reusable prompt for at least twice can become a skill. Start from a prompt that already works — if you need one, draft it in the Prompt Generator first, then convert it.
The spec defines a small set of fields every agent understands. Tool-specific extras are ignored by some agents — and outright rejected by some upload flows (the claude.ai skill upload is strict) — so keep the shared file to spec fields and put tool extras in per-tool copies or metadata.
Structure the body as: When to use (and when not to) → numbered steps → exact output format → edge cases. Keep the body under 500 lines / roughly 5,000 tokens; move long reference material into references/ files the agent opens only when needed.
Deterministic steps (date maths, file renaming, format conversion) belong in scripts/. Judgement steps belong in prose. Every extra script is also attack surface — see the security check below.
A complete, non-coding skill — chasing unpaid invoices, the kind of task professionals repeat weekly:
--- name: invoice-chaser description: Draft a polite-but-firm payment reminder for an overdue invoice. Use when the user mentions an unpaid, overdue, or late invoice, a client who hasn't paid, or asks for a payment follow-up email. Not for quotes, receipts, or first invoices. license: MIT metadata: author: PromptStaging version: 1.0 --- # Invoice Chaser ## When to use - An invoice is past its due date and the user wants a reminder drafted. - Do NOT use for issuing a first invoice, quotes, or payment receipts. ## Steps 1.
Ask for (or extract): invoice number, client name, amount + currency, due date, days overdue. 2. Choose tone by days overdue: 1–7 days = friendly nudge; 8–21 = firm, restate terms; 22+ = final notice, state next step.
3. Draft the email: subject `Payment reminder: Invoice #[number] — [amount]`, body under 120 words, include amount, due date, and a clear pay-by date 7 days out. 4.
End with one line: what changes if they don't pay (late fee / pause of work), only if the user confirms one applies. 5. Output ONLY the email (subject + body) unless the user asks for explanation.
Enter fullscreen mode Exit fullscreen mode Build this in the Skill Builder, then run it through the Quality Check Builder before installing it anywhere.
Run five fresh prompts in each agent: three that should trigger the skill (phrased differently each time — formal, casual, typo-ridden) and two that should not (adjacent tasks: a quote request, a receipt). Score: 3/3 triggers + 0/2 false fires = ship it. If it under-triggers, the description is too narrow — add the missing phrasings. If it over-triggers, add explicit "not for…" cases.
A skill's scripts execute with your credentials. Before installing anyone else's skill: read the SKILL.md end to end, read every script, and only install from sources you would trust with code — because that is literally what it is. Pin a version; re-read on update.
New since September 2026: MCP's SEP-2640 extension lets an MCP server publish skills alongside its tools — the layers are converging, not competing. When you need the capability half, build it in MCP Studio.
Does one skill work in Claude Code, Codex and Cursor? Yes — the Agent Skills format is a shared standard, and all three read SKILL.md files. What differs is the folder each one scans; keep the master in.agents/skills and link or copy it into each agent's folder (map above).
Where do I put SKILL.md files? In a folder named exactly after the skill, inside a skills directory:.agents/skills/<name>/SKILL.md for the shared standard location,.claude/skills/<name>/SKILL.md for Claude Code,.github/skills/<name>/SKILL.md for Copilot projects — personal skills live in the matching folders under your home directory.
How long should a SKILL.md be? Keep the body under 500 lines (about 5,000 tokens). Longer material belongs in references/ files inside the skill folder, which the agent opens only when the task needs them.
Do I need to code to write a skill? No. A skill is a Markdown file with a small YAML header. Scripts are optional and only worth adding when a step has exactly one correct answer. The invoice-chaser example above is prose only.
Is SKILL.md the same as AGENTS.md? No. AGENTS.md holds always-on project rules and loads every session. A SKILL.md loads only when a request matches its description — it is on-demand know-how, not standing rules. Most setups use both.
Are Claude Skills and Agent Skills the same thing? Agent Skills is the open standard Anthropic created and donated to the Linux Foundation's Agentic AI Foundation in October 2026. "Claude Skills" is Anthropic's implementation of that same standard inside Claude products — skills written to the standard also work in other agents.
Take one prompt you reuse weekly and turn it into a skill: draft it in the Skill Builder, validate it with the 5-prompt trigger test, and install it from one master folder. Want ready-made starting points? The Skills Directory collects production skills — including release notes for developers and listing copy, invoice and HR skills for professionals — that you can copy, customise and run through the same test before they go anywhere near your agents.