AI Agents für HR18 Min. Lesezeit

SKILL.md Files und das Cobrainer Ökosystem

Was SKILL.md Files sind, wie Du sie schreibst und wie Cobrainer sie generiert, harmonisiert und governed — von Job Architecture bis Agent Playbooks.

Was ist eine SKILL.md File

Eine SKILL.md File ist ein strukturiertes Markdown-Dokument, das Schritt-für-Schritt-Instruktionen für einen spezifischen Task oder eine Capability definiert. Sie ist das operative Playbook, das ein AI Agent liest, bevor er einen Task ausführt.

Stell Dir vor: eine detaillierte Arbeitsanweisung — aber geschrieben für AI Agents statt Menschen. Sie sagt dem Agent: was der Task ist, wann er ausgelöst wird, welche Schritte zu folgen sind, welche Tools zu nutzen, welche Success Criteria gelten und wie Edge Cases gehandhabt werden.

SKILL.md Files sind die Brücke zwischen menschlichem Wissen und Agent-Ausführung. Sie kodieren organisationale Expertise in ein Format, das AI Systems konsumieren und darauf handeln können.

Struktur einer SKILL.md File

Eine gut strukturierte SKILL.md File enthält diese Abschnitte:

Abschnitt	Zweck	Beispiel
Title	Klarer Name des Tasks	«Screen Candidates Against Role Profile»
Description	Ein-Absatz-Zusammenfassung dessen, was der Skill tut	«Scores candidate applications against the skill matrix of a specified role...»
When to Use	Trigger-Bedingungen für den Agent	«Use when a hiring manager requests candidate screening for an open requisition»
Prerequisites	Was vor der Ausführung wahr sein muss	«Role profile exists in Cobrainer. ATS MCP server is connected.»
Steps	Geordnete Instruktionen, denen der Agent folgt	«1. Retrieve role profile via Cobrainer MCP. 2. Fetch candidate list from ATS...»
Tools Required	MCP Server und Tools, die der Agent braucht	«Cobrainer MCP: get_role_profile. ATS MCP: search_candidates.»
Success Criteria	Wie prüfen, ob der Task korrekt abgeschlossen wurde	«Shortlist of top 5 candidates generated with reasoning for each.»
Edge Cases	Was tun, wenn etwas schiefgeht	«If fewer than 5 candidates match, lower proficiency threshold by 1 level...»
Quality Checks	Validierungsregeln, die der Agent anwendet	«All candidates must have at least 3 of 5 required skills at target proficiency.»

Best Practices für SKILL.md Files

One Task, One File

Jede SKILL.md File deckt genau einen diskreten Task ab. Keine Rolle. Kein Prozess. Ein Task.

Eine Rolle wie «Senior Recruiter» kann 15–20 Tasks umfassen. Jeder Task bekommt seine eigene SKILL.md File: «Screen Candidates», «Draft Requisition», «Conduct Reference Check», «Generate Offer Letter». Die Rolle ist ein Composite. Die Tasks sind atomic.

Clear Trigger Conditions

Der Agent muss wissen, wann er einen Skill nutzt. Vage Trigger («when needed») führen zu Missbrauch. Spezifische Trigger («when a hiring manager submits a screening request for an open requisition with at least 10 applicants») führen zu zuverlässiger Ausführung.

Measurable Success Criteria

Jede SKILL.md File definiert, was «done» bedeutet. Nicht «candidates are screened», sondern «a ranked shortlist of the top N candidates is generated, each with a skill-match score and written reasoning, saved to the ATS as a screening report.»

Version Control und Ownership

SKILL.md Files sind lebende Dokumente. Sie brauchen Version Control (wer änderte was, wann), Ownership (wer für die Pflege verantwortlich ist) und Review-Zyklen (sind die Instruktionen noch akkurat?).

Cross-References

Tasks existieren selten isoliert. Eine «Screen Candidates» SKILL.md sollte die «Draft Requisition» SKILL.md referenzieren (weil Screening von einer gut definierten Requisition abhängt) und die «Generate Shortlist Report» SKILL.md (weil Screening in Reporting mündet).

Das Problem: Verstreute, ung governed SKILL.md Files

Heute baut jeder tech-affine Mitarbeitende sein eigenes AI-Agent-Setup. Sie erstellen Ordner auf ihren Rechnern mit einzelnen Projekten. Manche haben Orchestration-Tools eingerichtet. Viele haben ihre eigenen SKILL.md Files geschrieben — ad hoc, undokumentiert, inkonsistent.

Das Ergebnis:

Keine Konsistenz — derselbe Task wird über Teams hinweg unterschiedlich beschrieben
Keine Governance — niemand reviewt oder approviert die Instruktionen, denen Agents folgen
Keine Wiederverwendung — jeder reinvented das Rad
Keine Security — SKILL.md Files können Agents anweisen, Systeme ohne ordentliche Autorisierung zu nutzen
Keine Ausrichtung — einzelne SKILL.md Files reflektieren nicht die tatsächlichen Role Definitions, Skill-Anforderungen oder Compliance-Regeln der Organisation

Das ist dasselbe Problem, das Organisationen vor 20 Jahren mit Job Descriptions hatten: Jeder Manager schrieb seine eigene, in seinem Format, mit seinen Kriterien. Job Architecture hat das gelöst. SKILL.md Governance braucht dieselbe Lösung.

Cobrainers Rolle: Das SKILL.md Management Ökosystem

Cobrainer ist einzigartig positioniert, dieses Problem zu lösen — weil Cobrainer bereits jede Job Role in Tasks zerlegt und jeder Task auf Skills mappt. SKILL.md Files repräsentieren im Kern Tasks von Job Roles. Die Verbindung ist direkt.

Generation: Von Job Architecture zu SKILL.md Files

Der Flow:

Job Architecture definiert Families, Clusters, Roles, Levels
Jede Role enthält eine Liste von Tasks
Jeder Task mappt auf Skills und Proficiency Levels
Cobrainer generiert eine SKILL.md File für jeden Task — komplett mit Steps, Tool Requirements, Success Criteria und Edge Cases

Die SKILL.md File wird aus der Architecture abgeleitet. Sie wird nicht von einer Person erfunden — sie wird aus der organisationalen Struktur berechnet.

Harmonization: One Task, One SKILL.md, Everywhere

Derselbe Task erscheint in mehreren Rollen. «Conduct Stakeholder Interview» existiert in Business Analyst, Product Manager und UX Researcher Roles. Ohne Harmonization schreibt jedes Team eine andere SKILL.md für denselben Task.

Cobrainer harmonisiert: eine kanonische SKILL.md pro Task. Wenn der Task in 5 Rollen erscheint, referenzieren alle 5 dieselbe File. Variationen (unterschiedliche Tools, unterschiedliche Kontexte) werden über Parameter gehandhabt, nicht über separate Files.

Centralized Repository: Nicht Laptops, eine governed Library

Statt SKILL.md Files verstreut über einzelne Rechner und Ordner:

Central Storage — alle SKILL.md Files leben in einem governed Repository
Version Control — jede Änderung getrackt, vollständige Diff History, Rollback-Fähigkeit
Access Control — wer kann SKILL.md Files lesen, modifizieren und deployen
Distribution — Agents pullen die neueste SKILL.md aus der zentralen Quelle. Keine veralteten lokalen Kopien.

Derived from Structure: Architecture ändert sich, SKILL.md Files updaten

Wenn eine Role sich ändert — neue Tasks hinzugefügt, Skills updated, Proficiency Targets angepasst — updaten die daraus abgeleiteten SKILL.md Files automatisch. Die Architecture ist die Single Source of Truth. SKILL.md Files sind downstream Artefakte.

Consistent Governance Rules

Jede von Cobrainer generierte SKILL.md File erbt organisationale Regeln:

Security Rules — welche Systeme der Agent nutzen kann, welche Daten er lesen oder schreiben darf
Ethics Rules — Fairness-Constraints, Bias-Checks, Human-in-the-Loop-Requirements
Brand Personality — Tone of Voice, Communication Style, Language Rules
Data Sources — wo der Agent Informationen holt (nur approvte MCP Server)
Compliance Constraints — DSGVO, Pay Transparency, Arbeitsrecht

Diese Regeln sind nicht in einzelnen Files eingebettet — sie werden aus organisationaler Policy angewendet, konsistent, über alle generierten SKILL.md Files hinweg.

SKILL.md Files als Brücke

SKILL.md Files verbinden zwei Welten:

Welt	Inhalt	Owner
Job Architecture	Roles, Tasks, Skills, Proficiency Levels, Organisationsstruktur	HR, Organization Design, Cobrainer
Agent Operations	Playbooks, Tool Configurations, Execution Rules, Quality Criteria	IT, Operations, AI Teams

SKILL.md Files sind die Translation Layer. Sie nehmen, was die Organisation definiert (in der Job Architecture), und verwandeln es in das, was Agents ausführen (in operationalen Workflows).

Cobrainer managed beide Seiten — und die Übersetzung dazwischen. Das macht es zum Management-Ökosystem für SKILL.md Files: nicht nur Generator, sondern die Governance-, Versioning-, Distribution- und Synchronisations-Schicht, die Agent-Operationen mit Organisationsdesign aligned hält.