Naar hoofdinhoud gaan

Skills

Skills zijn herbruikbare promptmodules. Door een SKILL.md te laden kun je instructies voor een specifiek domein aan een session toevoegen.

Overzicht

  • Hergebruik domeinkennis in de vorm van skills
  • Deel hetzelfde gedrag tussen projecten
  • Schakel skills per session in of uit
In de Laravel-versie configureer je dit via skillDirectories en disabledSkills van SessionConfig.

Basisgebruik

skillDirectories zijn expliciete roots voor het detecteren van skills. Je kunt ze gebruiken onafhankelijk van de instelling enableConfigDiscovery. Als je een bovenliggende directory opgeeft, wordt de SKILL.md in elke onderliggende subdirectory gedetecteerd. Dit dient alleen voor detectie en geeft de agent geen algemene toegangsrechten tot bestanden.
Je kunt dit ook als array opgeven.

Skills uitschakelen

Met disabledSkills kun je een deel van de geladen skills uitschakelen.

Directorystructuur

In skillDirectories geef je een bovenliggende directory op zoals skills/. Relatieve paden worden eenmalig opgelost ten opzichte van de effectieve workingDirectory op het moment van opgeven.
  • Weglaten of null: andere detectiebronnen blijven ongewijzigd
  • []: alleen de expliciet opgegeven SDK-roots worden gewist
disabledSkills, uitschakeling per bron en Managed Settings zijn ook van toepassing op skills die via expliciete roots worden gedetecteerd.

Het formaat van SKILL.md

SKILL.md is Markdown en kan optioneel YAML-frontmatter bevatten.
De belangrijkste frontmatter-velden:
  • name: de identifier van de skill (de naam die je in disabledSkills gebruikt)
  • description: een korte beschrijving van de skill
Als je name weglaat, wordt de directorynaam gebruikt.

Combineren met custom agents

Als je skillnamen opgeeft in customAgents[].skills, wordt de inhoud van die skills vooraf geladen wanneer de betreffende agent start.
Als je skills weglaat, wordt er geen skillinhoud in de agent geïnjecteerd.

Bekijken en beheren via RPC

Het detecteren en in-/uitschakelen van skills kan ook via RPC.

Best practices

  • Splits skills op per domein (skills/security, skills/testing, enz.)
  • Voeg name en description toe aan de frontmatter
  • Sluit conflicterende instructies expliciet uit met disabledSkills
  • Test skills eerst afzonderlijk voordat je meerdere skills combineert

Zie ook

Laatst gewijzigd op 19 oktober 2026