InloggenBriefing plannen

Hoofdstuk 2.20

Vaardigheden

Hoe u een Skills Engine-vaardigheid schrijft, test en publiceert, waar deze verschijnt zodra deze live is, en waarin manifestvaardigheden in een plug-in verschillen. Bevat een uitgewerkt overzicht voor ligplaatstoewezing voor Harrow Port Authority.

Deze pagina is door AI vertaald vanuit het Engelse origineel. Als er iets onduidelijk is, geldt de Engelse pagina als referentie. Lees deze pagina in het Engels

17 minuten leestijd

Tomás Reilly, de platformengineer bij Harrow Port Authority, vroeg mij vorige maand waarom zijn ligplaatsplanners telkens een ander antwoord kregen wanneer ze de assistent vroegen: "wie ligt er morgen op welke ligplaats, en wat is er verschoven?". Het antwoord was dat niemand de assistent had verteld hoe een goed antwoord eruitziet. Een Skills Engine-skill loste dit in één middag op: de planners krijgen nu elke keer dezelfde driedelige samenvatting, met eerst de ligplaatstabel, daaronder de wijzigingen sinds de vorige planning en als laatste de conflicten. Dit hoofdstuk doorloopt die skill van begin tot eind en behandelt daarna het andere soort skill: degene die in het manifest van een plug-in staat.

Twee soorten vaardigheden

Nexus gebruikt het woord "skill" voor twee verschillende dingen, en ze zijn verschillend opgebouwd.

Skills Engine-skill Manifest-skill
Wat het is Een SKILL.md-pakket in de skills-bibliotheek Een getypeerde rij in de skills[]-array van een plug-in
Wie het schrijft Iedereen met de juiste rechten, in de creator of in de eigen editor Een ontwikkelaar, binnen een plug-in
Wat het bevat Instructies, de tools die het mag aanroepen, optionele bestanden en scripts Een invoer- en uitvoerschema, een tier en de velden die dat tier nodig heeft
Hoe het op het platform komt Gevalideerd, geüpload en gepubliceerd naar de Skills Engine Gecompileerd vanuit het manifest en gesynchroniseerd met het skill-register
Wat het uitvoert De assistent, agents, workflows, AI-knoppen (kunstmatige intelligentie), Claude Code UNO-dispatch (de workflow-engine)
Typisch gebruik "Vat de ligplaatsplanning elke keer op dezelfde manier samen" "Voer onze baanpropagator uit op deze passage"

De rest van het hoofdstuk houdt ze uit elkaar. Als er in een alinea alleen "skill" staat, gaat het om een Skills Engine-skill.

Deel 1: Skills Engine-vaardigheden

Wat een skill is

Een skill is een map. De SKILL.md beschrijft waar de skill voor dient en hoe de taak moet worden uitgevoerd; daarnaast staan eventuele bestanden die de taak nodig heeft en scripts die worden uitgevoerd. De engine laadt een skill in drie lagen: de naam en beschrijving altijd, de instructies wanneer een taak om de skill vraagt, en de bestanden pas wanneer een stap ze nodig heeft. Daarom kan een installatie tweehonderd skills bevatten en er vrijwel niets voor betalen totdat er een wordt gebruikt.

skills/<slug>/
├── SKILL.md      # required: YAML frontmatter, then the instructions
├── skill.yaml    # optional: engine metadata (triggers, aliases, tags, capabilities)
└── scripts/      # optional: bundled with the skill as components

De mapnaam moet gelijk zijn aan de slug van de skill. Een afwijking levert een validatiewaarschuwing op die u het beste kunt oplossen, omdat de bibliotheek aan de hand van de slug een upload koppelt aan een bestaande skill.

SKILL.md-frontmatter

De frontmatter is YAML tussen twee ----regels bovenaan het bestand. Het formaat vereist drie velden. De validatie zelf blokkeert slechts op enkele punten: een ontbrekende naam of beschrijving, en een slug of taaktype dat al in gebruik is. Al het overige wordt gemeld als waarschuwing.

Veld Type Verplicht Wat het bevat
name string ja De unieke identificatie, in kebab-case
description string ja Wat de skill doet, maximaal 500 tekens. De bibliotheek en de matcher lezen dit, dus schrijf het voor een lezer die moet bepalen of dit de juiste skill is
allowed-tools string of lijst ja De tools die de skill mag aanroepen. Dit kan de allow-list van degene die de skill uitvoert alleen inperken
triggers lijst nee Slash-opdrachten die de skill rechtstreeks aanroepen
capabilities lijst nee Gestructureerde mogelijkheden, elk met een name, een description en optioneel input_schema, output_schema en examples
version string nee Een semantische versie; 1.0.0 indien weggelaten
visibility string nee private, team of public
status string nee draft, testing of published

Houd de instructies onder ongeveer 5.000 tokens. Wees specifiek en geef voorbeelden. Elke skill moet één taak goed uitvoeren; als u merkt dat u "en ook" schrijft, hebt u waarschijnlijk te maken met twee skills.

skill.yaml

skill.yaml bevat wat de engine nodig heeft voor vindbaarheid en de bibliotheek, zodat de SKILL.md leesbaar blijft. De velden die de engine leest zijn onder meer name, display_name, description, version, status, visibility, triggers, aliases, category, tags, allowed_tools en capabilities. Een mogelijkheid kan query_patterns bevatten: de formuleringen die de matcher ernaartoe moet sturen. Er zijn ook aanwijzingen voor de eigen budgettering van de engine: complexity, estimated_tokens en required_services.

scripts/

Alles onder scripts/ wordt ongewijzigd als component meegebundeld met de skill. Een script wordt uitgevoerd, nooit ingelezen in de context van het model, en draait in een sandbox. Gebruik een script wanneer een stap bestaat uit rekenwerk of parsen dat een model niet uit het hoofd zou moeten doen.

Zichtbaarheid en status

Zichtbaarheid bepaalt wie de skill kan vinden: private bent uzelf, team is uw team en public is iedereen in de organisatie die door de bibliotheek wordt bediend. In de console heet dezelfde keuze "Alleen ik", een team zoals "Douaneafdeling", of de hele organisatie, en een skill kan ook worden gedeeld in een domeinpakket via de eigen beoordeling van dat pakket.

De status geeft aan in welke fase van de levenscyclus de skill zich bevindt.

Status Betekenis
draft Onderhanden werk; niet vindbaar
testing Wordt gevalideerd, met beperkte toegang
published Beschikbaar voor algemeen gebruik
deprecated Vervangen; wordt binnenkort uitgefaseerd

Zodra een versie is gepubliceerd, verandert deze nooit meer. In de console zijn "live", "canary" en "shadow" labels op versies, en terugschakelen naar een eerdere versie verplaatst een label. Lopende uitvoeringen worden afgerond op de versie waarmee ze zijn gestart.

Nieuwe skill · 2 Instructies en tools
Nieuwe skill · 2 Instructies en tools
De tweede stap van de creator toont het concept van SKILL.md, de bijbehorende bestanden en wanneer elk bestand wordt geladen, en de tools die de skill mag aanroepen. Een controlerende skill krijgt geen schrijftools aangeboden, en een skill kan de allow-list van de uitvoerder alleen inperken.

Van een map naar een live skill

Vijf npm-scripts in de repository van de Skills Engine brengen een skill van uw editor naar de bibliotheek en bewijzen dat deze is aangekomen.

Opdracht Wat deze doet
npm run skill:validate skills/<slug> Voert een lint-controle uit op het pakket. Voor publicatie zijn nul fouten vereist
npm run skill:upload skills/<slug> Valideert en publiceert in één stap; idempotent
npm run skill:upload skills/<slug> --dry-run Valideert en drukt het plan af zonder iets weg te schrijven
npm run skill:publish -- --dry-run skills/<slug> De onderliggende publicatie achter upload, dezelfde pijplijn
npm run skill:reconcile Vergelijkt de skills in uw repository met wat de bibliotheek en het skill-register bevatten
npm run skill:live:verify Controleert een gepubliceerde skill van begin tot eind op de draaiende installatie

Publiceren schrijft twee vermeldingen weg, en beide zijn van belang. De ene is de skill zelf, met de SKILL.md-inhoud, mogelijkheden, componenten en kwaliteitsregistratie; de bibliotheek, vindbaarheid en matching lezen die vermelding. De andere is de registervermelding waartegen de workflow-engine een dispatch omzet. Een skill die alleen het register heeft bereikt, werkt wel, maar blijft onzichtbaar in de bibliotheek totdat u deze uploadt.

Publiceren is idempotent. Een ongewijzigde skill leidt tot een no-op, en een bestaande skill wordt gekoppeld op basis van zijn slug en ter plekke bijgewerkt, nooit opnieuw aangemaakt. Als u dezelfde bytes uploadt als een reeds gepubliceerde versie, krijgt u die versie terug met CONTENT_HASH_ALREADY_PUBLISHED, geen duplicaat.

skill:reconcile legt de skills in uw repository naast de bibliotheek, het register en de inventaris van de workflow-engine, en meldt alles wat op de ene plek wel bestaat maar op de andere niet. skill:live:verify gaat nog een stap verder op de draaiende installatie: beide vermeldingen bestaan en verwijzen naar elkaar met dezelfde inhoudshash, een dry-run-dispatch van het taaktype van de skill wordt geaccepteerd, de skill verschijnt in het overzicht en de detailweergave van de bibliotheek, de skill kan worden aangeroepen en de audittrail koppelt de publicatie, de dispatch en de uitvoering aan elkaar via slug en aanvraag-ID.

Vanaf een werkstation bereikt de upload de kennisservice van de installatie, nexus-graphrag, via een port-forward, en is de servicesleutel van de Skills Engine vereist in de omgeving. Laad de sleutel zonder deze op het scherm weer te geven:

kubectl -n nexus port-forward svc/nexus-graphrag 8090:8090
read -rs GRAPHRAG_SKILLS_ENGINE_SERVICE_KEY
export GRAPHRAG_SKILLS_ENGINE_SERVICE_KEY
GRAPHRAG_URL=http://localhost:8090 npm run skill:upload skills/berth-allocation-summary

Binnen het cluster, in een pijplijntaak, wordt het standaardadres vanzelf omgezet en is GRAPHRAG_URL niet nodig. Haal de sleutel op via het eigen secrets-proces van uw organisatie. De sleutel hoort nooit thuis in de repository, uw shellgeschiedenis of de uitvoer van een opdracht.

Tests, goedkeuring en livegang

Een skill komt als concept in de bibliotheek terecht, en de creator houdt deze daar vast totdat drie onderdelen zijn geslaagd.

Controle Wat deze doet
Testcases Elke testcase moet slagen voordat de skill ter goedkeuring kan worden ingediend. Een testcase kan alleen met opgaaf van reden worden verwijderd, en de goedkeurders krijgen die reden te zien.
Een dry-run in shadow De skill wordt uitgevoerd op werk uit het verleden, waarbij niemand de antwoorden ziet, en de resultaten worden vergeleken met wat een medewerker destijds heeft besloten.
Een blinde beoordeling door een model uit een andere familie Hierbij wordt gezocht naar een gemiste controle, een verzonnen bron en een verborgen instructie die de skill heeft opgevolgd terwijl dat niet had gemogen.

Daarna volgt de goedkeuring. Een skill die een schrijftool toevoegt, wordt vastgehouden totdat twee personen deze met hun passkey goedkeuren, en degene die de skill heeft voorgesteld mag daar niet een van zijn (PUBLISH_NEEDS_APPROVAL). Daarna gaat de skill live in shadow, vervolgens in canary voor één afdeling achter benoemde gates, en daarna voor iedereen. Als aan een canary-gate niet wordt voldaan, stopt de canary vanzelf en blijft iedereen op de vorige versie; vervroegd uitrollen naar iedereen vereist een reden en een tweede goedkeurder (CANARY_GATE_NOT_MET).

In Community zijn de creator, bibliotheek, versies en tests allemaal aanwezig, en publiceert de eigenaar zelfstandig zodra de tests zijn geslaagd. Canary, goedkeuring door twee personen, plug-insynchronisatie en het samenvoegen van duplicaten zijn onderdeel van Enterprise.

Nieuwe skill · 4 Publiceren
Nieuwe skill · 4 Publiceren
Publiceren laat zien waarom een skill wordt vastgehouden, wie akkoord moet gaan en hoe de skill live gaat: goedgekeurd, in shadow, in canary achter benoemde gates, en vervolgens voor iedereen. De indiener kan zijn eigen wijziging niet goedkeuren, en de vorige versie blijft gereed om naar terug te schakelen.

Waar skills verschijnen

Dezelfde gepubliceerde skill bereikt gebruikers op vijf plekken.

  1. De assistent koppelt een verzoek aan een skill op basis van de beschrijving, triggers en zoekpatronen, en volgt de instructies van de skill.
  2. Agents en workflows roepen skills aan als stappen. Een workflowstap benoemt de skill; de uitvoering legt vast welke versie is gebruikt.
  3. AI-knoppen op schermen voeren elk één skill uit. Een beheerder kan "Over deze knop" openen om te zien welke skill een knop uitvoert, wat deze leest en wie deze het laatst heeft gewijzigd, en kan de knop uitschakelen zonder de skill zelf aan te passen.
  4. Uw IDE (integrated development environment) en Claude Code bereiken de bibliotheek via de Workbench en dertien MCP-tools (Model Context Protocol): waaronder list_skills, get_skill, match_prompt, discover_skills, invoke_skill, record_execution, create_skill, import_skill, get_generation_job en sync_skills_local. Elke aanroep wordt uitgevoerd namens de persoon die deze heeft gestart, binnen diens allow-list.
  5. De skills-bibliotheek zelf, waar gebruikers door skills bladeren, ze uitvoeren en wijzigingen voorstellen, en waar beheerders van elke skill de eigenaar, gebruikers, uitvoeringen en kosten zien.

Wat een skill ook uitvoert, de skill kan nooit verruimen wat de uitvoerder mag doen: hij roept alleen tools aan binnen de allow-list van de uitvoerder en leest alleen wat die persoon mag openen (SKILL_CANNOT_WIDEN_TOOLS). Een uitvoering zonder modelroute wordt geweigerd in plaats van gegokt (SKILLS_ENGINE_BINDING_MISSING); de dispatcher kiest de route uit de eigen modelconfiguratie van de organisatie.

Over deze knop
Over deze knop
Over deze knop toont de skill die een AI-knop uitvoert, de drie bronnen die deze leest, wie de skill heeft geschreven en beoordeeld, en wat er in de nieuwste versie is gewijzigd. Door de knop uit te schakelen wordt deze overal tegelijk verwijderd; de skill en alle eerdere antwoorden blijven behouden.

Uitgewerkt voorbeeld: een samenvatting van de ligplaatstoewijzing voor Harrow

De planners van Harrow hadden al twee alleen-lezen-tools op hun allow-list vanuit de eigen ligplaatsplanningsplug-in van Harrow: berth-plan.read retourneert de planning voor een datum, en vessel-call.read retourneert een scheepsaanloop met het aankomstvenster en de lengte. Meer heeft de skill niet nodig. Hij schrijft nooit gegevens weg, en heeft dus nooit twee goedkeurders nodig.

---
name: berth-allocation-summary
description: Summarise tomorrow's berth plan at Harrow for the planning desk. Use when someone asks who is on which berth, what moved since the last plan, or where two calls clash.
allowed-tools: berth-plan.read, vessel-call.read
triggers:
  - /berth-summary
capabilities:
  - name: summarise_berth_plan
    description: The berth table, the changes since the last plan and any clashes, for one date
version: 1.0.0
visibility: team
status: draft
---

# Berth allocation summary

## When to use
A planner asks about the berth plan for a date, or asks what changed.

## Steps
1. Read the plan for the date with berth-plan.read. If no date is given, use tomorrow.
2. For each call on the plan, read it with vessel-call.read.
3. Write the berth table first: berth, vessel, arrival window, length overall.
4. Then list what moved since the previous plan, one line per change, with the reason the plan records.
5. Then list clashes: two calls whose windows overlap on one berth, or a vessel longer than the berth.
6. Cite the plan's version for every line. Never guess a time the plan doesn't give.

## Output
Three headed sections, in this order: Berths, Changes, Clashes. Write "No clashes" when there are none.

De bijbehorende skill.yaml geeft de bibliotheek een weergavenaam, een categorie en de formuleringen die de matcher hierheen moet leiden:

# skill.yaml, beside SKILL.md
name: berth-allocation-summary
display_name: "Berth allocation summary"
version: "1.0.0"
status: draft
visibility: team
category: operations
tags:
  - berths
  - planning
triggers:
  - "/berth-summary"
allowed_tools:
  - berth-plan.read
  - vessel-call.read
capabilities:
  - name: "summarise_berth_plan"
    description: "Berth table, changes since the last plan and clashes, for one date"
    query_patterns:
      - "who is on which berth tomorrow"
      - "what moved on the berth plan"
      - "any berth clashes on *"

Vervolgens de opdrachten, vanuit de hoofdmap van de repository:

npm run skill:validate skills/berth-allocation-summary
npm run skill:upload skills/berth-allocation-summary --dry-run
npm run skill:upload skills/berth-allocation-summary

Tomás heeft zes testcases toegevoegd in de creator: een gewone dag, een dag met een vertraagde aankomst waardoor twee aanlopen zijn verschoven, een dag met een daadwerkelijk conflict, een datum waarvoor nog geen planning is, een schip dat te lang is voor zijn ligplaats, en een verzoek dat probeerde de skill een nieuwe ligplaats te laten voorstellen (dat mag niet; hij heeft geen schrijftool). De dry-run speelde twintig eerdere planningen opnieuw af in shadow. Toen de testcases waren geslaagd, keurde een beoordelaar van de planningsafdeling de skill goed en ging deze live voor het planningsteam. De assistent beantwoordt de vraag nu elke keer in dezelfde vorm, en de AI-knop van de planners op de pagina met de ligplaatsplanning voert dezelfde skill uit.

Deel 2: manifestvaardigheden

Een manifest-skill is de rekeneenheid die een plug-in publiceert. Deze wordt gedeclareerd in de skills[] van het manifest, gevalideerd door de SDK (software development kit) wanneer u create-nexus-plugin validate uitvoert, gecompileerd naar de registerinhoud door compileRegistry, en gesynchroniseerd met het skill-register. U schrijft nooit handmatig register-SQL, zodat de rij die het platform aanstuurt en de descriptor die u hebt gedeclareerd nooit uit elkaar kunnen gaan lopen.

Elke manifest-skill vereist id, displayName, description, tier, classification, inputSchema en outputSchema. Declareer ook timeoutMs: dit is een geheel getal van 1,000 tot 21,600,000 (één seconde tot zes uur), en een waarde buiten dat bereik wordt geweigerd met TIMEOUT_OUT_OF_BOUNDS. dataResidency is any, eu of us, en any is de standaardwaarde.

De id is in lower_snake, en de dispatch-sleutel van het register is het taaktype met namespace <plugin name>.<skill id>, zodat twee plug-ins beide een summarise-skill kunnen hebben zonder met elkaar te botsen. Hier is de ene skill uit het sjabloon, ingekort:

{
  "id": "sentiment_score",
  "displayName": "Sentiment score",
  "description": "Deterministic lexicon-based sentiment score for a piece of text.",
  "tier": "host_callback",
  "classification": "tenant",
  "dataResidency": "any",
  "inputSchema": { "type": "object", "properties": { "text": { "type": "string", "minLength": 1 } }, "required": ["text"] },
  "outputSchema": { "type": "object", "properties": { "score": { "type": "number" } }, "required": ["score"] },
  "hostCallback": {
    "service": "my-plugin",
    "port": 8080,
    "path": "/internal/skills/sentiment_score",
    "maxRequestBytes": 262144,
    "maxResponseBytes": 16384,
    "tenantHeader": "X-Organization-ID"
  },
  "timeoutMs": 10000
}

De vijf tiers

Het tier is geen label. Elk tier heeft zijn eigen velden, en een veld dat bij een ander tier hoort, wordt geweigerd met FIELD_NOT_FOR_TIER in plaats van stilzwijgend genegeerd.

Niveau Vereist Spreekt een model aan Wie het uitvoert
host_callback hostCallback: uw Service, de poort, een pad en beide bytelimieten Nee Het platform stuurt de invoer via POST naar uw eigen Service, binnen uw namespace
plugin_queue queueName, gespeld als <plugin name>.<name> Nee Uw worker, die taken ophaalt uit uw wachtrij
tool_using systemPrompt en tools[]; vertrouwensniveau core of verified Ja Het platform, via de AI Provider Router; elke tool-aanroep loopt via een op de allow-list geplaatste executor
llm_only systemPrompt; vertrouwensniveau core of verified Ja Het platform, één aanroep via de AI Provider Router
map map.perItemJobType, met de naam van een andere skill uit hetzelfde manifest die geen map is Alleen via het doel Het platform voert het doel één keer per item uit en verzamelt de resultaten

Geen van beide model-tiers benoemt een provider of een model. De router kiest beide uit de eigen pool van de aansturende organisatie. Een tool in een tool_using-skill benoemt een van de zes executors: standing_service_call (uw eigen Service), graphrag, graphrag_query, graphrag_search, h3 of web_search. Elke andere waarde wordt geweigerd met EXECUTOR_NOT_PERMITTED. De drie knowledge-graph-executors accepteren alleen de toolnamen graphrag_query en graphrag_search, omdat de executor de bewerking uitvoert waarnaar de tool is vernoemd.

Er bestaan twee tiers in het register die een plug-in niet kan declareren: ketens en skills die zelfstandig draaien, worden uitsluitend door het platform geschreven. Een synchronisatie waarin er zo een wordt genoemd, wordt in zijn geheel geweigerd.

Welk tier te gebruiken

  • host_callback wanneer het werk een functie is van de invoer die door uw eigen code wordt berekend: een score, een berekening, een opzoekactie in uw eigen schema. Dit is het eenvoudigst te testen en de standaardkeuze van het sjabloon. Beveilig de callback-route: een pad in een manifest is geen geheim, en de route moet de aanroep van het platform verifiëren en de organisatie daaruit overnemen, nooit uit de body. Declareer het als auth: internal en koppel er requireService (Fastify) of serviceMiddleware (Express) aan. De beveiliging weigert een token dat voor iemand anders is uitgegeven. Antwoord snel en zorg dat een tweede aflevering van dezelfde taak geen kwaad kan.
  • plugin_queue voor langer durend werk waarop iemand wacht, waarbij uw worker eigenaar is van de levenscyclus. De worker moet de uitvoering bij de start op running zetten en bij voltooiing op een eindstatus; een worker die alleen zijn resultaat post, laat de uitvoering voor altijd op queued staan.
  • llm_only wanneer één modelaanroep met een vaste systeemprompt volstaat voor de taak, en uw plug-in core of verified is.
  • tool_using wanneer het model in een lus tools moet aanroepen, wederom alleen bij core of verified.
  • map wanneer u wilt dat het platform een van uw andere skills uitwaaiert over een lijst.

Mijn baanpropagatie-skill bij Corrán Orbital is een host_callback. Onze plug-in is community, dus de model-tiers waren nooit een optie, en ik mis ze ook niet: een propagator die op dinsdag een ander antwoord geeft, zou erger zijn dan nutteloos.

Goedkeuring vóór elke uitvoering

Een manifest-skill die nooit enkel op gezag van een machine mag worden uitgevoerd, declareert dat als volgt:

"approval": { "required": true, "reason": "Re-planning a pass needs the flight dynamics lead." }

required is altijd true; een skill die geen goedkeuring nodig heeft, laat het blok weg. reason is wat de goedkeurder te zien krijgt, 1 tot 500 tekens na het verwijderen van witruimte aan begin en eind, en elke andere vorm wordt geweigerd met APPROVAL_INVALID. Een dispatch van de skill wordt dan vastgehouden: de dispatch antwoordt 202 met status: "awaiting_approval" en een waitpointId, en alleen de goedkeuring van een aangewezen persoon geeft deze eenmalig vrij. Een batch-, map- of keten-dispatch van een vastgehouden skill wordt geweigerd met SKILL_APPROVAL_NOT_HOLDABLE, omdat een fan-out zijn items niet kan vasthouden. Geef het vastgehouden antwoord weer en laat de goedkeurder beslissen; voer geen dispatch uit om pas daarna om toestemming te vragen.

Synchroniseren met het register

Elke synchronisatie is declaratief en wordt in zijn geheel gecontroleerd. Stuur telkens de volledige set skills mee: een skill die u weglaat, wordt uitgeschakeld, terwijl de uitvoeringsgeschiedenis behouden blijft. Eén foutieve skill zorgt ervoor dat de hele synchronisatie wordt geweigerd met SYNC_CONTRACT_VIOLATION, waarbij alle overtredingen samen worden vermeld en er niets wordt weggeschreven, zodat een plug-in nooit half wordt bijgewerkt. Hoofdstuk 2.22, De plug-in-runtime, behandelt de synchronisatie-aanroep en hoe het platform weet welke plug-in de aanroep doet.

Skills in de IDE en Claude Code
Vaardigheden in de IDE en Claude Code
Skills in de IDE en Claude Code toont dezelfde stappen voor valideren, uploaden en publiceren vanuit de eigen terminal van een ontwikkelaar, waarbij het concept wordt vastgehouden voor goedkeuring omdat de auteur haar eigen wijziging niet kan goedkeuren.

Kiezen tussen de twee soorten

Als de opdracht luidt "zeg dit elke keer op dezelfde manier", dan is het een Skills Engine-skill. Als de opdracht luidt "voer mijn code uit en geef mij het antwoord", dan is het een manifest-skill. Het meeste werk in de praktijk komt neer op een combinatie van beide: de ligplaatssamenvatting van Harrow is een Skills Engine-skill waarvan de tools afkomstig zijn uit een plug-in, en de tools van die plug-in zijn op hun beurt gedeclareerd in het bijbehorende manifest. De Skills Engine-skill is van de twee het goedkoopst om aan te passen, wat een goede reden is om de formulering en de beoordeling daar onder te brengen en het rekenwerk in de plug-in te houden.

De kosten zijn in beide gevallen reëel. Een Skills Engine-skill is niet klaar wanneer de SKILL.md vlot leest; hij is pas klaar wanneer de testcases slagen, de dry-run overeenkomt met wat mensen hebben besloten, en iemand anders dan uzelf hem heeft goedgekeurd. Reken op een week voor een skill die gegevens wegschrijft, waarvan het grootste deel opgaat aan de canary.