Skills sind SKILL.md-Dateien, die Sie in Ihre Repositories committen und mit denen Sie Devin wiederverwendbare Abläufe beibringen — jeden wiederholbaren Workflow, den Devin konsequent befolgen soll. Das Testen Ihrer App vor dem Eröffnen eines Pull Request (PR), das Bereitstellen in einer Umgebung, das Untersuchen einer Codebasis, das Erstellen des Grundgerüsts für einen neuen Service — wenn Sie es als Schritt-für-Schritt-Anleitung schreiben können, können Sie es in einen Skill verwandeln.
Sie folgen dem offenen Agent Skills standard, sodass dieselben Skill-Dateien in mehreren KI-Coding-Tools funktionieren.
Legen Sie Skill-Dateien in Ihrem Repository unter .agents/skills/<skill-name>/SKILL.md ab. Devin findet sie automatisch in all Ihren verbundenen Repositories. Die vollständige Referenz zum Dateiformat finden Sie in der Agent Skills specification.
Warum Skills wichtig sind
- Jedes Mal auf die gleiche Weise ausgeführt werden sollte — Test-Checklisten, Bereitstellungsschritte, Review-Prozesse
- Repo-spezifisches Wissen erfordert — welche Services gestartet werden müssen, welche Ports zu verwenden sind, welche Befehle ausgeführt werden müssen
- Von dynamischem Kontext profitiert — Git-Diffs, Branchnamen oder Umgebungsinformationen, die beim Aufruf eingebunden werden
Devin schlägt Skills automatisch vor
- Einer Zusammenfassung dessen, was gelernt wurde (z. B. „how to start the backend with Docker“)
- Dem vorgeschlagenen Inhalt der Datei
SKILL.md
- Einem „Create PR“-Button, um den Skill in Ihr Repo zu committen
Im Laufe der Zeit baut Devin in Ihrem Repo eine Bibliothek von Skills auf, die beschreiben, wie Ihre Anwendung ausgeführt, getestet und bereitgestellt wird.
Testen vor dem Öffnen einer PR
---
name: test-before-pr
description: Run the local dev server and verify pages before opening any PR that touches frontend code.
---
## Setup
1. Install dependencies: `npm install`
2. Start the database: `docker-compose up -d postgres`
3. Run migrations: `npx prisma migrate dev`
4. Start the dev server: `npm run dev`
5. Wait for "Ready on http://localhost:3000"
## Verify
1. Read the git diff to identify which pages changed
2. Open each affected page in the browser
3. Check for: console errors, layout issues, broken links
4. Screenshot each page at desktop (1280px) and mobile (375px) widths
## Before Opening the PR
1. Run `npm run lint` and fix any issues
2. Run `npm test` and confirm all tests pass
3. Include screenshots in the PR description
Bereitstellen in einer Umgebung
---
name: deploy
description: Deploy the app to a target environment and run smoke tests.
argument-hint: <environment>
triggers: ["user"]
---
## Deploy
1. Make sure you are on the correct branch for this deploy
2. Run `./scripts/deploy.sh $0`
3. Wait for the deploy script to complete successfully
## Verify
1. Curl `https://$0.example.com/health` and confirm a 200 response
2. Run the smoke test suite: `npm run test:smoke -- --env=$0`
3. Report the deployment URL and test results
## Current context
- Branch: !`git branch --show-current`
- Last commit: !`git log --oneline -1`
@skills:deploy staging ersetzt staging durch $ARGUMENTS und $0, und die !`command`-Blöcke fügen aktuelle Git-Informationen ein. Das Feld triggers: ["user"] stellt sicher, dass Devin diesen Skill nur ausführt, wenn Sie ausdrücklich darum bitten — er wird nicht automatisch aktiviert.
Untersuchung eines Teils der Codebasis
---
name: investigate
description: Research a part of the codebase and produce a written summary with file references.
allowed-tools: Read, Grep, ListDir
argument-hint: <topic or area to investigate>
---
## Research
1. Search the codebase for files related to: $ARGUMENTS
2. Read the most relevant files thoroughly
3. Trace the call chain and data flow
## Summarize
1. Write a summary of how $ARGUMENTS works
2. Include specific file paths and line numbers for every claim
3. Note any concerns, edge cases, or areas that need attention
allowed-tools beschränkt Devin auf schreibgeschützte Vorgänge — keine Änderungen, keine Shell-Befehle. Das ist nützlich für Erkundungsaufgaben, bei denen Sie Analysen ohne Seiteneffekte benötigen.
Devin entdeckt Skills aus zwei Quellen, die zu Beginn jeder Session zusammengeführt werden:
- Indizierte Repos — Das Backend von Devin indiziert
SKILL.md-Dateien in allen Repositories, die mit deiner Organisation verbunden sind. Diese stehen sofort beim Start einer Session zur Verfügung, noch bevor Repos geklont werden.
- Geklonte Repos — Sobald Repositories auf die Maschine der Session geklont werden, durchsucht Devin sie nach
SKILL.md-Dateien auf dem Datenträger. Beim Scannen des Datenträgers gefundene Skills aktualisieren oder überschreiben passende indizierte Skills aus demselben Repo, sodass Devin immer die neueste Version auf dem jeweils bearbeiteten Branch verwendet.
Wenn ein Repo-Klon während einer laufenden Session fertiggestellt wird, scannt Devin dieses Repo automatisch erneut, damit neu hinzugefügte oder geänderte Skills ohne Neustart übernommen werden.
Unterstützte Speicherorte für Skill-Dateien
SKILL.md-Dateien in allen folgenden Verzeichnissen:
.agents/skills/<skill-name>/SKILL.md (empfohlen).github/skills/<skill-name>/SKILL.md.claude/skills/<skill-name>/SKILL.md.cursor/skills/<skill-name>/SKILL.md.codex/skills/<skill-name>/SKILL.md.cognition/skills/<skill-name>/SKILL.md.windsurf/skills/<skill-name>/SKILL.md
Alle sieben Pfade werden in jedem Repository durchsucht.
Was Devin aus einer Skill-Datei lädt
----Block oben) ein und extrahiert:
| Field | Purpose |
|---|
name | Identifiziert die Skill. Fällt, falls ausgelassen, auf den Namen des übergeordneten Verzeichnisses zurück. |
description | Kurze Zusammenfassung, die in der Skill-Liste angezeigt wird, damit Devin (und Sie) wissen, was die Skill macht. |
allowed-tools | Beschränkt, welche Tools Devin verwenden kann, solange die Skill aktiv ist. |
| Field | Purpose |
|---|
argument-hint | Hinweistext, der zusammen mit dem Skill-Namen angezeigt wird und die erwarteten Argumente beschreibt. |
triggers | Steuert, wer die Skill aufrufen kann — standardmäßig ["user", "model"]. Setzen Sie den Wert auf ["user"], um zu verhindern, dass Devin sie automatisch aktiviert. |
$ARGUMENTS — wird durch den vollständigen Argument-String ersetzt, der beim Aufruf der Skill übergeben wird (z. B. über @skills:deploy staging prod). Sie können auch einzelne Argumente per Index abrufen: $ARGUMENTS[0] oder $0 für das erste, $ARGUMENTS[1] oder $1 für das zweite usw. Argumente werden anhand von Leerzeichen getrennt.!`command` — der Befehl wird im Repository-Stammverzeichnis ausgeführt und durch sein stdout ersetzt, sodass Skills dynamische Werte wie Branchnamen oder Portnummern einbinden können.
Wie Devin Skills verwendet
SKILL.md und fügt deren Inhalt als Systemanweisung in seinen aktuellen Kontext ein. Das bedeutet, dass Devin die Schritte des Skills für den Rest der Aufgabe aktiv befolgt — es ist nicht nur eine Referenz, sondern steuert Devins Verhalten direkt.
Devin kann Skills auf verschiedene Arten verwenden:
Wenn Devin feststellt, dass ein Skill für die aktuelle Aufgabe relevant ist, wird er automatisch ausgeführt. Wenn du Devin zum Beispiel bittest, einen Bug im Frontend-Code zu beheben und es gibt einen test-before-pr-Skill, aktiviert Devin ihn, bevor der Pull Request (PR) eröffnet wird. Setze triggers: ["user"] im Frontmatter, um das automatische Ausführen für Skills zu verhindern, die du nur manuell auslösen möchtest.
Erwähne einen Skill in deinem Prompt
@skills:skill-name in deine Nachricht einfügst:
Fix the login bug on the /auth page @skills:test-before-pr
$ARGUMENTS, $ARGUMENTS[0], $1 usw. vorkommen.
Nur eine aktive Fähigkeit gleichzeitig
- Globale / organisationsweite Skills — Aktuell befinden sich Skills innerhalb von Repositories. Für organisationsweite Skills kann als Workaround ein dediziertes „skills“-Repository erstellt werden. Wir arbeiten an nativer Unterstützung für organisationsweite Skills, die für alle Repositories gelten.
- Kombinieren mehrerer Skills — Derzeit kann immer nur ein Skill gleichzeitig aktiv sein. Wir arbeiten an Unterstützung für das Verketten und Kombinieren von Workflows.
Sowohl Skills als auch Playbooks stellen Devin wiederverwendbare Anweisungen zur Verfügung, funktionieren aber unterschiedlich:
| Skills | Playbooks |
|---|
| Where they live | In deinem Repo als SKILL.md-Dateien – versionsverwaltet zusammen mit deinem Code | In der Devin-Web-App – verwaltet über die UI |
| How they’re triggered | Devin entdeckt und verwendet sie automatisch, oder du referenzierst sie in jedem Prompt mit @skills:name | Manuell an eine Session angehängt, wenn du sie startest |
| Scope | Auf ein Repo begrenzt – Devin wählt die passenden Skills basierend auf den Repos aus, die für die Aufgabe relevant sind | Organisationsweit – jedes Teammitglied kann jedes Playbook an jede Session anhängen |
| Auto-suggestion | Devin schlägt neue Skills vor, nachdem er deine App getestet oder etwas Neues gelernt hat | Manuell von Teammitgliedern erstellt |
| Best for | Testprozeduren, lokale Dev-Setups, Deployment-Checklisten, repo-spezifische Workflows | Wiederverwendbare Prompt-Vorlagen, repo-übergreifende Aufgabenmuster, Onboarding-Guides |
Wenn du bereits Playbooks hast, die gut funktionieren, besteht kein Zeitdruck für eine Migration – sie werden weiterhin funktionieren. Für neue Anweisungen empfehlen wir jedoch, mit Skills zu beginnen.
- Agent Skills specification — der offene Standard für das
SKILL.md-Dateiformat, Frontmatter-Felder und die Verzeichnisstruktur
- Knowledge — für kontextuelle Tipps und Fakten (keine Schritt-für-Schritt-Anleitungen)
- Playbooks — für wiederverwendbare Prompt-Vorlagen, die Sitzungen zugeordnet sind
