TrueFoundry Skills Registry uitgelegd: versiebeheer van procedurele kennis over agents heen

Skills verpakken instructies, referenties, scripts en assets in herbruikbare procedures. Een registry maakt die pakketten vindbaar en voorziet ze van versiebeheer—maar maakt ze niet automatisch betrouwbaar.

Een skill is een pakket van procedures, geen nieuwe permissie

Een agent skill beschrijft hoe een terugkerende taak moet worden uitgevoerd. De root SKILL.md bevat een naam, een actiegerichte beschrijving en de procedure. Een uitgebreider pakket kan referentiemateriaal, scripts en assets bevatten. Deze structuur scheidt procedurele kennis van een monolithische system prompt en stelt de runtime in staat om alleen details te laden wanneer de skill relevant is.

Het onderscheid tussen kennis en autoriteit is belangrijk. Een skill kan een agent vertellen hoe hij een datawarehouse moet bevragen, een incident moet triageren of release-notities moet opstellen. Het verleent op zichzelf geen databasetoegang, autoriseert geen incidentrespons en maakt een gegenereerde release-notitie niet automatisch correct. Tools, credentials, gateway-beleid en stroomafwaartse systemen blijven het autorisatiepad.

De Skills Registry van TrueFoundry geeft het pakket een gedeelde identiteit. Skills bevinden zich in Repositories, erven repositorytoegang en versiehistorie over, en worden geadresseerd via genummerde fully qualified names (FQN's). Teams kunnen eenmalig publiceren en het pakket hergebruiken in TrueFoundry Agents, Claude Code of Cursor.

Progressive disclosure vermindert de initiële context door alleen selectiemetadata te tonen. Het maakt de geselecteerde procedure niet automatisch veilig, dus het volledige pakket blijft een beheerd artefact.

Progressive disclosure is het ontwerp van de runtime

TrueForge documenteert dat een gekoppelde skill alleen zijn naam en beschrijving bijdraagt aan de initiële modelcontext. De volledige SKILL.md-inhoud wordt pas op verzoek uit de sandbox gelezen wanneer de agent besluit dat de skill relevant is. Dit vermindert de initiële context terwijl de procedure beschikbaar blijft.

De beschrijving is daarom een routing-oppervlak. Als deze vaag is, kan de agent de skill niet selecteren of selecteren voor de verkeerde taak. Houd het actiegericht, geef aan wanneer de skill moet worden gebruikt en vermijd overlappende beschrijvingen die de selectie ambigu maken. Selectiegedrag moet worden geëvalueerd met realistische gebruikersverzoeken, inclusief 'near misses'.

Progressief laden beheert de contextgrootte; het isoleert geen onvertrouwde inhoud. Eenmaal geselecteerd, beïnvloeden de skill-inhoud en ondersteunende bestanden de agent. Scripts kunnen worden uitgevoerd binnen de geconfigureerde sandbox en referenties kunnen het toolgebruik vormgeven. Behandel een skill met meerdere bestanden als een software-artefact met een supply chain.

Drie publicatiepaden, één van versiebeheer voorzien artefact

TrueFoundry documenteert drie publicatiepaden. De UI maakt een skill uit één bestand waarvan de inhoud de in de editor geschreven SKILL.md-tekst is. Pakketten met meerdere bestanden gebruiken het CLI upload-commando of een declaratief manifest dat via GitOps wordt toegepast. Alle paden maken een van versiebeheer voorziene Skill onder een Repository en leveren een FQN op, zoals een repository-gekwalificeerde skill op versie 1.

De UI ondersteunt momenteel alleen het enkele SKILL.md-bestand. Referenties, scripts en assets vereisen een CLI- of GitOps-pad; ondersteuning voor meerdere bestanden in de UI is gedocumenteerd op de roadmap. De CLI valideert de frontmatter en uploadt het pakket. GitOps wijst een manifest toe aan een lokale skill-map en publiceert via dezelfde apply-workflow die voor andere TrueFoundry-resources wordt gebruikt.

De publicatiepaden verschillen operationeel, maar komen samen op dezelfde repository- en versie-identiteit. Die identiteit stelt agents en lokale coderingsomgevingen in staat een concreet pakket te consumeren in plaats van een informele kopie.

Repositorytoegang wordt overgeërfd

Skills hebben geen afzonderlijke permissies per skill in het gedocumenteerde model. Rechten voor ontdekking, bewerking en gebruik worden overgeërfd van de bovenliggende Repository. Dat maakt repository-grenzen de praktische eenheid van governance. Groepeer skills op basis van compatibel eigenaarschap en gevoeligheid in plaats van elke procedure in één catalogus met brede toegang te plaatsen.

Repositorytoegang bepaalt wie het pakket mag ophalen of gebruiken. Het beperkt niet elke actie die de skill aanbeveelt. Een gebruiker die een database-skill kan gebruiken, heeft nog steeds autorisatie nodig op het niveau van de database-tool en de zakelijke resources. Omgekeerd intrekken van een skill trekt de onderliggende tooltoegang niet noodzakelijkerwijs in.

Versiepinning is het fundament van reproduceerbaarheid

De documentatie van de Skills CLI vereist een positief geheel getal als versie bij het downloaden en geeft aan dat een latest-alias niet wordt ondersteund. Dat is een nuttige operationele eigenschap: consumenten noemen een concreet pakket. Pin dezelfde concrete versie in agent-configuraties en lokale ontwikkelomgevingen wanneer u vergelijkbaar gedrag nodig hebt.

Een versie heeft nog steeds herkomst (provenance) nodig. Leg de commit van de bron-repository, de uitgever, het build- of verpakkingsproces, bestandshashes, afhankelijkheden en het evaluatieresultaat vast. Pin voor scripts externe pakketten en leg de uitvoeringsomgeving vast. Een genummerde FQN identificeert wat de registry heeft opgeslagen; herkomst legt uit hoe dat pakket tot stand is gekomen.

Scripts en referenties brengen verschillende risico's met zich mee

Referentiebestanden kunnen verouderd, onvolledig of kwaadwillig gewijzigd zijn. Scripts kunnen gegevens lezen en transformeren, lokale commando's uitvoeren of services aanroepen via beschikbare interfaces. Assets kunnen actieve of onjuist geformatteerde inhoud bevatten. Controleer elke klasse met een passende beheermaatregel in plaats van de map te behandelen als ongedifferentieerde Markdown.

Statische controles kunnen frontmatter, path traversal, archiefstructuur, bestandsgrootte, verboden binaire bestanden, afhankelijkheidsdeclaraties en bekende gevaarlijke patronen valideren. Tests in een sandbox kunnen scripts testen met synthetische invoer en geweigerde netwerktoegang. Taakevaluaties kunnen meten of de agent de skill kiest en de beperkingen ervan naleeft. Menselijke beoordeling moet gericht zijn op geprivilegieerde procedures en onomkeerbare acties.

De acceptatie-pipeline scheidt opslag, inspectie, taakprestaties en runtime-autorisatie. Geen enkele afzonderlijke controle certificeert elke eigenschap van een skill.

Promotie moet rekening houden met de consument

Zelfde skill kan worden gebruikt door een TrueFoundry Agent, Claude Code en Cursor, maar die omgevingen delen niet noodzakelijkerwijs identieke modellen, tools, sandboxing of gebruikersidentiteit. Portabiliteit van het formaat betekent geen gelijkheid van runtime-gedrag. Test de skill op elke ondersteunde omgeving en leg de omgeving vast in het resultaat.

Een skill die veilig is in combinatie met read-only MCP-tools, kan onveilig zijn wanneer een lokale coderingsomgeving schrijftoegang en shell-commando's biedt. Release-metadata moet de verwachte toolafhankelijkheden, vereiste permissies, compatibele runtime-versies en verboden omgevingen vermelden.

Een gedisciplineerde skill-levenscyclus

Begin met een afgebakende taak en een beschrijving die de selectie testbaar maakt. Schrijf de procedure met expliciete voorwaarden, toegestane tools, bewijsvereisten, foutafhandeling en stopregels. Publiceer een kandidaatversie. Voer statische, sandbox- en gedragstests uit. Keur het goed voor aangewezen consumenten. Observeer selectie, toolgebruik, fouten en resultaten. Trek de versie in door consumenten en toegang te verwijderen, en bewaar vervolgens het door het beleid vereiste bewijsmateriaal.

Pas een veelgebruikte skill niet rechtstreeks aan via informele bestandsdistributie. Publiceer een nieuwe versie, vergelijk het volledige pakket (diff) en rol consumenten gecontroleerd om. Wanneer een kwetsbaarheid wordt gevonden in een script of referentie, identificeer dan elke consumerende agent en ontwikkelomgeving via de versie-inventaris.

Genummerde versies zijn identiteiten, geen compatibiliteitsgaranties

Een versienummer vertelt consumenten welk pakket ze hebben ontvangen. Het communiceert op zichzelf niet of een update achterwaarts compatibel is. Een gewijzigde toolnaam, bestandspad, uitvoerschema of vereiste permissie kan een agent breken, zelfs als de procedure vergelijkbaar leest.

Publiceer compatibiliteitsmetadata naast het pakket: verwachte runtime, vereiste tools, ondersteunde in- en uitvoercontracten, afhankelijkheidsversies, dataclassificaties en bekende migraties. Houd bij brekende wijzigingen de eerdere versie lang genoeg beschikbaar zodat consumenten gecontroleerd kunnen overstappen. Voorkom dat agents worden geleerd om tijdens de runtime een wisselend "latest"-pakket te downloaden; stel het goedgekeurde nummer vast tijdens de release.

Inventarisatie is essentieel voor incidentrespons

Wanneer een referentie onjuist blijkt te zijn of een scriptafhankelijkheid is gecompromitteerd, moeten responders snel twee vragen kunnen beantwoorden: welke versies bevatten het probleem, en waar worden die versies gebruikt? De registry-identiteit biedt het eerste ankerpunt, maar de consumenteninventaris moet ook TrueFoundry Agents en eventuele lokale Claude Code- of Cursor-installaties omvatten die zijn gesynchroniseerd vanuit de registry.

Lokale kopieën kunnen langer blijven bestaan dan wijzigingen in de repositorytoegang. Het intrekken van gebruiksrechten voorkomt toekomstige ophaalacties, maar wist een pakket dat al naar een ontwikkelaarsmachine is gedownload niet. Incidentplannen moeten onderscheid maken tussen registry-insluiting, ontkoppeling in de runtime, lokale remediëring, intrekking van tool-credentials en stroomafwaartse reconciliatie. Buitengebruikstelling is pas voltooid wanneer risicovolle autorisaties en getroffen kopieën zijn aangepakt.

Resultaatevaluatie moet de procedure volgen

Evaluatie van skills vereist meer dan alleen selectietests. Controleer of de agent voorafgaande voorwaarden volgt, de bedoelde tools gebruikt, rij- of kostenlimieten respecteert, omgaat met ontbrekende gegevens, de juiste referenties citeert en stopt vóór ongeautoriseerde effecten. Controleer vervolgens het gezaghebbende taakresultaat. Een syntactisch correcte tool-traject kan nog steeds leiden tot een slecht zakelijk resultaat.

Sla de skill-FQN op bij elke evaluatie en runtime-trace. Daarmee kunnen teams versies vergelijken, regressie detecteren en bepalen of een fout veroorzaakt wordt door de skill, het model, de tool, de data of het omliggende beleid. Zonder de koppeling naar de versie wordt het onmogelijk om een gedeelde procedure op schaal te beheren.

Fouttests die het bewaren waard zijn

• Gebruik prompts die de skill wel en niet zouden moeten selecteren; meet foute selecties en gemiste selecties.
• Publiceer een pakket met meerdere bestanden dat onverwachte paden, symlinks, te grote bestanden en niet-gedeclareerde afhankelijkheden bevat.
• Wijzig alleen een ondersteunend script of referentie; bevestig dat het verschil in het pakket en de versiewijziging dit zichtbaar maken.
• Voer dezelfde versie uit over ondersteunde omgevingen en vergelijk het bereik en gedrag van de tools.
• Trek de repository-gebruikstoegang in en bevestig dat consumenten geen nieuwe kopie kunnen ophalen.
• Verwijder een skill uit een agent terwijl de tooltoegang intact blijft; bevestig dat het onderscheid wordt begrepen.
• Stel een kwetsbare versie buiten gebruik en inventariseer elke vastgepinde consument voordat u de remediëring als voltooid beschouwt.

Hoe Skills Registry en TrueForge samenkomen

Skills Registry is het distributie- en governance-oppervlak voor van versiebeheer voorziene procedurele pakketten. TrueForge is de runtime die de metadata van gekoppelde skills beschikbaar stelt, de volledige procedure op verzoek laadt en ondersteunend werk uitvoert via de sandbox en tools. AI Gateway en MCP Gateway beheren het model- en toolverkeer rond die runtime.

Geen van deze lagen certificeert een procedure. De nuttige platformvisie is compositioneel: registry-identiteit en repositorytoegang, runtime-contextbeheer, toolautorisatie en bewijsvoering kunnen worden afgestemd op dezelfde vastgepinde skill-versie.

De operationele regel

Behandel skills als release-artefacten die nauw verwant zijn aan code. Houd beschrijvingen nauwkeurig, pin genummerde versies, beoordeel het volledige pakket, test selectie en uitvoering, en stem repositories af op daadwerkelijke eigenaarschapsgrenzen.

De registry van TrueFoundry maakt procedurele kennis herbruikbaar over agents en ontwikkelomgevingen heen. TrueForge maakt die kennis efficiënt om te laden tijdens runtime. Het systeem wordt pas betrouwbaar wanneer versiebeheer wordt gekoppeld aan acceptatie, least privilege, sandboxing en resultaatbewijs.

Referenties

1. TrueFoundry — AI Gateway Skills Registry.
2. TrueFoundry — Create, Manage, and Use Skills.
3. TrueForge — Skills.
4. TrueForge — Harness Capabilities.

Redactionele vermelding. Dit artikel weerspiegelt de technische interpretatie van TrueFoundry van de geciteerde openbare materialen per 19 september 2026. Productmogelijkheden zijn beperkt tot de gekoppelde documentatie. Voorbeelden en standaardinstellingen zijn ter illustratie; ze vormen geen juridisch advies, een audit-oordeel, een onafhankelijke benchmark of een garantie voor beveiliging, veiligheid of compliance.

‍