> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills

> Beschreibt, wie Sie wiederverwendbare SKILL.md-Dateien laden und domänenspezifische Anweisungen über SessionConfig verwalten.

## Skills

Skills sind wiederverwendbare Prompt-Module. Sie laden `SKILL.md`-Dateien und fügen so einer Session domänenspezifische Anweisungen hinzu.

## Überblick

* Domänenwissen als Skill wiederverwenden
* Gleiches Verhalten projektübergreifend teilen
* Skills lassen sich pro Session aktivieren/deaktivieren

In der Laravel-Version erfolgt die Konfiguration über `skillDirectories` und `disabledSkills` in `SessionConfig`.

## Grundlegende Verwendung

Geben Sie in `skillDirectories` ein Elternverzeichnis an; die `SKILL.md`-Dateien in dessen Unterverzeichnissen werden geladen.

```php theme={null}
use Revolution\Copilot\Contracts\CopilotSession;
use Revolution\Copilot\Facades\Copilot;
use Revolution\Copilot\Types\SessionConfig;

Copilot::start(function (CopilotSession $session) {
    $response = $session->sendAndWait(prompt: 'この差分をセキュリティ観点でレビューして');

    dump($response->content());
}, config: new SessionConfig(
    skillDirectories: [
        base_path('skills'),
    ],
));
```

Die Angabe im Array-Format ist ebenfalls möglich.

```php theme={null}
Copilot::run(
    prompt: 'READMEの改善案を出して',
    config: [
        'skillDirectories' => [base_path('skills')],
    ],
);
```

## Skills deaktivieren

Mit `disabledSkills` können Sie einen Teil der geladenen Skills gezielt deaktivieren.

```php theme={null}
$config = new SessionConfig(
    skillDirectories: [base_path('skills')],
    disabledSkills: ['experimental-feature', 'deprecated-tool'],
);
```

## Verzeichnisstruktur

```text theme={null}
skills/
├── code-review/
│   └── SKILL.md
└── documentation/
    └── SKILL.md
```

Geben Sie in `skillDirectories` ein Elternverzeichnis wie `skills/` an.

## Format von SKILL.md

`SKILL.md` ist Markdown und kann optional ein YAML-Frontmatter enthalten.

```markdown theme={null}
---
name: code-review
description: Specialized code review capabilities
---

# Code Review Guidelines

When reviewing code, always check for:

1. Security vulnerabilities
2. Performance issues
3. Code style
4. Test coverage
```

Wichtige Frontmatter-Felder:

* `name`: Skill-Bezeichner (der in `disabledSkills` angegebene Name)
* `description`: Kurze Beschreibung des Skills

Wird `name` weggelassen, wird der Verzeichnisname verwendet.

## Mit Custom Agents kombinieren

Wenn Sie in `customAgents[].skills` Skill-Namen angeben, wird der Inhalt der jeweiligen Skills beim Start des zugehörigen Agenten vorab geladen.

```php theme={null}
use Revolution\Copilot\Types\SessionConfig;

$config = new SessionConfig(
    skillDirectories: [base_path('skills/security')],
    customAgents: [
        [
            'name' => 'security-auditor',
            'description' => 'Security-focused code reviewer',
            'prompt' => 'Focus on OWASP Top 10 vulnerabilities',
            'skills' => ['security-scan', 'dependency-check'],
        ],
    ],
);
```

> Wird `skills` weggelassen, werden dem Agenten keine Skill-Inhalte eingespeist.

## Prüfen und Steuern per RPC

Sie können Skills auch über RPC entdecken sowie aktivieren/deaktivieren.

```php theme={null}
// Skills auf Serverebene entdecken
$result = Copilot::client()->rpc()->skills()->discover();

// Liste der Skills innerhalb der Session
$session->rpc()->skills()->list();

// Innerhalb der Session einzeln aktivieren/deaktivieren
$session->rpc()->skills()->enable(['name' => 'security-scan']);
$session->rpc()->skills()->disable(['name' => 'security-scan']);
```

## Best Practices

* Skills nach Domäne aufteilen (z. B. `skills/security`, `skills/testing`)
* `name` und `description` im Frontmatter angeben
* Bei konfligierenden Anweisungen explizit über `disabledSkills` ausschließen
* Zunächst einzeln testen, bevor Sie mehrere Skills kombinieren

## Referenzen

* [SessionConfig](/de/packages/laravel-copilot-sdk/session-config)
* [Custom Agents](/de/packages/laravel-copilot-sdk/custom-agents)
* [RPC](/de/packages/laravel-copilot-sdk/rpc)


## Related topics

- [laravel/agent-skills – Offizielle KI-Agent-Skills-Sammlung von Laravel](/de/blog/agent-skills-introduction.md)
- [Laravel Boost](/de/boost.md)
- [Einen eigenen Agenten für Boost erstellen](/de/advanced/boost-custom-agent.md)
- [Laravel und KI-Entwicklung](/de/ai.md)
- [Streaming-Ereignisse](/de/packages/laravel-copilot-sdk/streaming-events.md)