Ga naar hoofdinhoud

Skills en tools

Gedeelde skills staan in .agents/skills/. Bewerk deze bronnen en voer daarna yarn ai-workflow:sync uit om .claude/skills/ voor Claude Code te genereren. Codex vindt skills rechtstreeks in .agents/skills/.

Gedeelde rolprompts staan in .agents/roles/*.md. Dit is een repository-specifiek bronformaat, geen native pad waarin agents worden gevonden. scripts/ai-workflow-files.mjs zet deze bronnen om in de app-specifieke bestanden hieronder; yarn ai-workflow:sync schrijft ze weg. Commit de gegenereerde bestanden samen met hun bronnen, zodat een verse checkout de native configuratie heeft zonder eerst een generator te draaien. Verwijder na het verwijderen van een bron de verouderde gegenereerde uitvoer expliciet; de validator rapporteert die, in plaats van bestanden stilzwijgend te verwijderen.

Native detectiepaden​

Geverifieerd aan de hand van de officiële documentatie op 2026-09-12:

AppProjectinstructiesSkills die deze repository gebruiktAangepaste agents die deze repository gebruikt
CodexAGENTS.md.agents/skills/<name>/SKILL.mdGegenereerde .codex/agents/<name>.toml
Claude CodeCLAUDE.md importeert @AGENTS.mdGegenereerde .claude/skills/<name>/SKILL.mdGegenereerde .claude/agents/<name>.md

Bronnen: Codex-skills, Codex-subagents, Claude-geheugen, Claude-skills, Claude-subagents.

Vervang de native agentmappen niet door .agents/roles en ga er niet van uit dat Claude .agents/skills vindt. Claude kan een bestand waarnaar daar wordt verwezen nog steeds lezen als gewone projectcontext.

De AI-mappen gebruiken LF-regeleinden via .gitattributes, zodat gegenereerde tekst op alle platforms identiek blijft. Ondersteunende assets van skills worden byte voor byte gekopieerd.

Skills​

SkillDoel
commitGeautoriseerde, afgebakende lokale commits maken
commit-format, issue-formatSuggesties opmaken wanneer daarom wordt gevraagd
make-closed-issueEen geautoriseerd issue, een afgebakende commit en een PR aanmaken
review-and-merge-prPR-feedback triëren; alleen binnen de gevraagde scope fixen, publiceren of mergen
fix-merge-conflictsConflicten oplossen en het samengevoegde resultaat verifiëren
releaseReleasetekst voorbereiden en geautoriseerde releasestappen uitvoeren
code-quality-reviewNiet-triviale diffs of een expliciet gevraagd kwaliteitsprobleem reviewen
retroAangetoonde fouten omzetten in gerichte checks of richtlijnen die herhaling voorkomen
refactor-pass, deslopGevraagde opschoning van bestaande wijzigingen
debug-agentDebuggen op basis van bewijs, met instrumentatie waar nodig
you-might-not-need-an-effectGerichte review van effects en memo's
vercel-react-best-practicesToepasselijke React-performancerichtlijnen; sla regels voor Next.js of alleen de server over voor deze Vite-client
translateVertalingen genereren en de maps daarna via één schrijver toepassen
playwright-cli, inspect-elementsBrowserverificatie en koppeling van DOM naar broncode
profile-browsingAfgebakende browser- en React-profilering
test-apkEen aangeleverde Android-companionwrapper verifiëren
impeccable, improve-threejsAfgebakend interfaceontwerp en review van Three.js-rendering
implement-planEen plan uitvoeren met optionele, begrensde delegatie
readmeGeverifieerde projectdocumentatie onderhouden
context7Bibliotheekdocumentatie ophalen die bij de versie past
find-skillsExtra skills zoeken wanneer daar expliciet om wordt gevraagd

Rollen en modellen​

Behoud aangepaste rollen voor browser-check, profiler, test-apk, translator en reviewer. Gebruik de ingebouwde worker-/general-purpose- of explorer-rol van de harness voor gewone implementatie en het verkennen van code. De bovenliggende agent wijst acceptatiecriteria en eigenaarschap toe; één eigenaar draait zware checks.

Codex-agentbestanden bevatten name, description en developer_instructions. .codex/config.toml beperkt het aantal gelijktijdige child-agents tot vier met max_concurrent_threads_per_session. Gedeelde rolmetadata bevat de naam, de beschrijving en een optionele sandboxmodus; er zitten bewust geen modelvelden in.

Laat model- en reasoningvelden weg uit gecommitte skills en aangepaste agents. Zo blijven keuzes bij het aanroepen tijdens runtime, standaardinstellingen van de gebruiker en overerving van de bovenliggende agent mogelijk volgens de gedocumenteerde voorrangsregels van elke app. Aliassen voor Claude-modelfamilies verminderen versieonderhoud, maar kiezen nog steeds een familie. Leg zulke keuzes waar nodig vast in gebruikers- of sessie-instellingen. Overerving belooft niet dat automatisch het beste actuele model wordt gekozen. Verzin geen latest-alias en voeg geen onderzoek naar de modelcatalogus toe aan routinetaken. Zie modelkeuze in Codex en modelkeuze in Claude.

sandbox-mode: read-only komt overeen met de sandbox van Codex. Bij Claude beperken de toollijst en de rolinstructies de reviewworkflow, maar Bash-toegang is geen sandbox op OS-niveau.

Gedeelde skill-frontmatter gebruikt waar van toepassing disable-model-invocation: true voor workflows die de gebruiker zelf aanroept. De overeenkomstige instelling van Codex staat in agents/openai.yaml als policy.allow_implicit_invocation: false; de validator vereist beide. Aanroepmetadata vult expliciete autorisatieregels aan; een reviewverzoek geeft nooit toestemming om te publiceren alleen omdat een skill publicatiestappen bevat.

Checks en detectie​

  • yarn ai-workflow:sync genereert de compatibiliteitsuitvoer opnieuw met de geïnstalleerde js-yaml en smol-toml.
  • yarn ai-workflow:check parseert bronnen, frontmatter en configuraties, en controleert gegenereerde uitvoer, aanroepmetadata, de plaatsing van modelvelden en de koppeling van de hook die alleen formatteert. Het controleert modelidentifiers niet tegen de catalogus van een provider.
  • yarn ai-workflow:test draait geïsoleerde Node-fixtures voor hook-payloads en voor het genereren en valideren van de workflow.
  • Controleer na het upgraden van een agentapplicatie of skills en rollen in die applicatie worden gevonden. Syntaxis- en pariteitschecks vervangen geen loadercheck. Herlaad de applicatie als een bestaande sessie een oude catalogus vasthoudt.
  • Hooks vereisen het projectvertrouwen en de hookreview van de harness; omzeil het vertrouwen niet om een check te laten slagen. Zie hooks-setup.md.

Bruikbare instructies onderhouden​

Volg de richtlijnen van OpenAI voor skills en prompts (bekeken op 2026-09-12): houd beschrijvingen precies, laad details alleen wanneer ze relevant zijn en respecteer de scope die de gebruiker heeft gevraagd. Gedeelde skills bedienen verschillende modellen; behoud projectspecifieke invarianten en laat ruimte voor routinematige implementatiekeuzes.

Houd het doel, de beslisgrenzen en de essentiële beperkingen van een skill in SKILL.md. Link omvangrijke modusspecifieke commando's of voorbeelden als optionele referenties. Zet triggervoorwaarden vooraan in korte beschrijvingen; een overeenkomend trefwoord alleen mag de taak niet uitbreiden. Behoud bestaande aanroepmetadata, tenzij het gedrag ervan bewust wordt gewijzigd.

Probeer na een substantiële wijziging in de instructies een paar representatieve kleine en grote verzoeken uit. Controleer welke skills en referenties werden geselecteerd, of acties binnen de scope bleven, of de verificatie bij de wijziging paste en of het geautoriseerde werk werd afgerond. Schema- en fixturetests stellen de correctheid van de tooling vast, niet de kwaliteit van de beslissingen van de agent.

Tools en browsereigenaarschap​

Geef de voorkeur aan de bestaande catalogus van skills en tools en aan de geïnstalleerde project-CLI's. Gebruik gh voor GitHub, playwright-cli voor browserverificatie en officiële, versiespecifieke documentatie wanneer het gedrag van een bibliotheek ertoe doet. Installeer geen dubbele skills en haal geen niet-vastgepind pakket op alleen om een bestaande formatter te draaien.

De overhead van MCP hangt af van de harness: uitgesteld laden van tools kan voorkomen dat elk schema vooraf wordt geladen. Houd integraties relevant in plaats van MCP zelf als achterhaald te behandelen. Bestaande CLI-keuzes blijven nuttig voor reproduceerbaarheid en controle over resources.

Alle browsersessies gebruiken ./scripts/pw-session.sh, dat machinebreed één actieve browser afdwingt. Begin standaard met een verse, geïsoleerde sessie. Toegang tot de huidige persoonlijke browser vereist expliciete autorisatie; hergebruik die autorisatie in volgende stappen. Kies browsers en viewports op basis van het getroffen gedrag, draai geselecteerde engines na elkaar, sluit bij het opruimen precies de benoemde sessie en gebruik nooit close-all/kill-all. Zie de playwright-cli-skill en verification.md.