Communitygithub.com

xEdit Automation — Hub Skill

Utiliser cette compétence lorsque la tâche implique l'inspection, la modification ou la création de plugins pour les jeux Bethesda via le démon xEdit forké. Elle se charge en premier et achemine vers le bon chemin (outil d'intention MCP, passage atomique MCP ou délégation à un sous-agent) et empêche l'agent de contourner le harnais.

Qu'est-ce que xEdit Automation — Hub Skill ?

Cette compétence est le point d'entrée principal, toujours chargé, pour tout travail avec xEdit. Elle constitue la source unique de vérité pour déterminer le chemin d'exécution à utiliser et les anti-patrons à éviter. Elle implémente un système de routage basé sur la forme de la tâche : les outils d'intention MCP pour les tâches fréquentes, le passage atomique MCP pour les cas nouveaux ou de débogage, la délégation à un sous-agent pour les opérations exploratoires, et `xedit_run_script` pour les mutations en masse. La compétence inclut également une doctrine complète de jugement pour la création de correctifs, avec des vérifications, des diagrammes de décision (comme le graphe DOT pour l'évaluation de la qualité d'un correctif), des capacités de divulgation progressive r6 (navigation ChildGroup, pagination, navigation inverse, spécification parent), et des règles de rédaction pour garantir la qualité des correctifs et éviter les erreurs (comme les copies sans intention ou les modifications de mods sources). Redflags et rationalisations aident à prévenir les erreurs courantes. La compétence est conçue pour fonctionner avec différents niveaux de démon (r6 ou antérieur) via des vérifications de capacités. Les références doivent être consultées via BGS KB pour les détails spécifiques au jeu.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/BB-84C/bgs-modding-superpowers/skills/xedit-automation

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

xEdit Automation — Compétence Hub

Cette compétence est le point d'entrée toujours chargé pour tout travail xEdit. Elle est la source unique de vérité pour "quel chemin utiliser" et "ce qu'il ne faut jamais faire". Les compétences spécialisées (par exemple xedit-conflict-audit) héritent de son routage, de ses anti-patrons et de sa discipline de vérification ; elles ne les répètent pas.

Boîte à outils en un coup d'œil (divulgation progressive, compatible r6)

Le démon xEdit forké est mieux traité comme une surface de divulgation progressive : commencez par les petits outils d'intention MCP, demandez au démon actif quels blocs de capacité r6 il supporte, puis passez aux modèles plus riches à un seul appel seulement lorsque la clé system.capabilities.supports.* correspondante est présente.

  • Découverte et session — xedit_session, xedit_list_capabilities. Appelez xedit_session en premier à chaque conversation. Ensuite, appelez xedit_list_capabilities une fois pour voir le résumé des commandes, contractVersionExpected et les ancrages r6 supports.*.
  • Lecture des enregistrements et des conflits — xedit_find_record, xedit_read_record, xedit_inspect_conflicts. Ce sont la colonne vertébrale W2 (audit de conflit) ; passez au passage atomique lorsque W2 a besoin d'un bloc de réponse r6 qu'aucun outil d'intention n'expose encore.
  • Passage atomique — xedit_call(command, args). Pour toute commande native du démon qui n'a pas encore d'outil d'intention. Exécute toujours le pipeline complet (validation → état → règles → audit). Utilisez-le à chaque fois que les outils d'intention ne conviennent pas.

Pour la documentation de référence approfondie, interrogez d'abord la BGS KB structurée (bgs_kb_query / bgs_kb_get). Les enregistrements de référence approfondie se trouvent sous knowledge/bgs-kb/packs/core/records/xedit/ (interrogeable via bgs_kb_query / bgs_kb_get).

Doctrine de routage (quel chemin utiliser)

Forme de la tâcheChemin
Intention connue à haute fréquence (auditer un conflit, lire un enregistrement, exécuter un travail, écrire un correctif)Outil d'intention MCP
Nouveau / débogage / composition libre de commandes nativesPassage atomique MCP : xedit_call(command, args) — toujours dans le harnais
Tempête d'opérations atomiques exploratoires (essais-erreurs, lecture-évaluation répétée, test d'hypothèses)Déléguer à un sous-agent investigateur en lecture seule avec cette compétence chargée ; le sous-agent utilise son propre contexte, retourne un résumé distillé
Mutation en masse importante et formalisableMCP xedit_run_script (Batch 4+) avec exécution à sec et instantané
Démon explicitement en mode par défaut (non-MCP), débogage manuel uniquementDirect xedit-client.ps1 est acceptable — mais UNIQUEMENT lorsque l'utilisateur a explicitement accepté le risque et que le démon n'est pas en mode -automation-mcp-mode

L'agent ne devrait jamais avoir de raison de contourner le MCP. Le passage atomique existe pour cela.

Jugement de création de correctifs

Aperçu

La création de correctifs ne consiste pas à "faire disparaître le rouge". C'est un petit argument de compatibilité : préservez le gagnant actuel, transmettez uniquement les valeurs en amont qui devraient encore survivre, et laissez derrière vous un plugin de correctif réversible dont le contenu dit ce que vous vouliez dire. Le tri est un levier à choix unique ; le correctif est la façon de garder les valeurs intentionnelles de deux mods actives en même temps. Mais vrai-en-principe n'est pas vrai-à-l'échelle-du-pack : si le plan est de recoudre chaque FormID parce que "xEdit peut tout réparer", le plan est déjà cassé.

Utilisez cette section lorsque vous êtes sur le point de créer ou de juger un correctif via le MCP. Utilisez xedit-conflict-audit d'abord lorsque la question est encore "qu'est-ce qui gagne, qu'est-ce qui entre en conflit, et cela devrait-il être un correctif ou un réordonnancement ?" Cette compétence possède l'appel correctif-vs-réordonnancement ; cette section possède le fait que le correctif que vous êtes sur le point d'écrire est bien formé.

Flux de décision : ce correctif est-il bien formé ?

digraph patch_authoring_judgment {
  // Les sauvegardes en attente d'arrêt bloquent les opérations du cycle de vie ; voir État sale et
  // contrôle de relance ci-dessous. Un redémarrage n'est pas un mécanisme de durabilité.
  rankdir=TB;
  node [shape=box];

  start [shape=doublecircle, label="Besoin d'un correctif ?"];
  audit [label="Auditer le gagnant réel + les champs de conflit\n(xedit-conflict-audit si pas déjà fait)"];
  reorder [shape=diamond, label="Le réordonnancement suffit-il\nsans perdre les valeurs nécessaires ?"];
  no_patch [shape=doublecircle, label="Pas de correctif : réordonner / laisser le gagnant\npuis vérifier la relecture"];
  winner [label="Copier/cibler le gagnant actuel\npas un perdant plus ancien"];
  intent [label="Nommer chaque valeur à transmettre\nQue fait-elle ? Pourquoi devrait-elle survivre ?"];
  noise [shape=diamond, label="Des valeurs copiées inchangées\nou du bruit de style ITM/vert ?"];
  clean [label="Supprimer les valeurs inchangées/sans intention"];
  refs [shape=diamond, label="Suppression ou marquage de suppression\nd'enregistrements/éléments ?"];
  referenced [label="Exécuter l'audit referencé_par / référence\nArrêter si les conséquences sont inconnues"];
  esl [label="Choisir délibérément la forme du correctif\nGénéralement ESP marqué ESL quand sûr ; éviter ESL/ESM natif si la liberté de tri est importante"];
  reversible [shape=diamond, label="Correctif réversible séparé\n(pas d'édition directe du mod source, pas de débordement d'écrasement non géré) ?"];
  fix_shape [label="Déplacer dans le mod MO2 géré\nou créer un plugin de correctif dédié"];
  verify [label="Sauvegarder + redémarrer + relire\nL'écrasement gagnant montre les valeurs intentionnelles"];
  pass [shape=doublecircle, label="Correctif bien formé"];

  start -> audit -> reorder;
  reorder -> no_patch [label="oui"];
  reorder -> winner [label="non, besoin de valeurs combinées"];
  winner -> intent -> noise;
  noise -> clean [label="oui"];
  noise -> refs [label="non"];
  clean -> refs;
  refs -> referenced [label="oui"];
  refs -> esl [label="non"];
  referenced -> esl;
  esl -> reversible;
  reversible -> fix_shape [label="non"];
  reversible -> verify [label="oui"];
  fix_shape -> verify -> pass;
  // Les sauvegardes en attente du contrat 0.23 utilisent xedit_flush ; le redémarrage seul n'est pas une preuve.
  verify [label="Sauvegarder + inspecter l'état en attente ; xedit_flush si nécessaire ; relecture fraîche"];
}

Correction de la sauvegarde différée : Le nœud historique Sauvegarder + redémarrer + relire du diagramme est remplacé. Si session.save signale un savePendingShutdownCount non nul, inspectez xedit_dirty, puis utilisez xedit_flush sur un démon de contrat 0.23. L'outil valide la réponse de drainage et confirme la sortie promise du démon. Un lastFlush partial ou inconnu n'est pas une preuve de durabilité. L'arrêt/redémarrage normal reste refusé tant qu'une file d'attente en attente existe ; force:true abandonne l'état et n'est jamais une preuve de durabilité.

Vérifications de création

  • Transmettre le gagnant. Le jeu lit l'écrasement final/gagnant pour un FormID. Construisez le correctif à partir du gagnant actuel, puis transmettez uniquement les valeurs du mod plus ancien qui doivent encore survivre.
  • Pas de cargo inchangé. Si une valeur copiée ne change pas de sens, c'est du bruit de style ITM, pas de la compatibilité. Supprimez-la à moins que vous puissiez indiquer pourquoi elle est intentionnellement conservée.
  • Correctif en tant que couche séparée. Ne glissez pas les valeurs directement dans le mod source simplement parce qu'il est la colonne la plus à droite aujourd'hui. Un correctif doit être réversible en désactivant/supprimant la couche de correctif, pas en supprimant manuellement des champs du plugin de quelqu'un d'autre.
  • Préserver les références. Si une suppression ou un marquage de suppression entre dans le plan, arrêtez-vous et exécutez d'abord le chemin référencé-par/relire. Des références inconnues signifient un rayon d'impact inconnu.
  • Choisir délibérément la forme du plugin. Les correctifs de compatibilité ordinaires veulent généralement la liberté de tri ESP normale plus le marquage ESL quand c'est sûr. Le comportement de l'ordre de chargement ESL/ESM natif n'est pas une mise à niveau de propreté gratuite.
  • Bon correctif contre correctif pansement. Un bon correctif a une intention nommée pour chaque valeur transmise et réduit la dette de conflit. Un correctif pansement copie des enregistrements entiers, édite les mods sources ou essaie de recoudre chaque FormID parce que le tri a été traité comme sans importance.

Discipline d'interrogation KB

Cette section de jugement est indépendante du jeu. Interrogez KB pour les pièges de correction spécifiques au jeu, les mises en garde des familles d'enregistrements et les faits actuels de la chaîne d'outils plutôt que de les fossiliser ici.

bgs_kb_query({ query: "xedit patch authoring gotchas", domains: ["xedit", "load-order"], games: ["<current game>"] })

Si KB est silencieux, marquez [GAP] et conservez la règle de correction au niveau du framework au lieu d'inventer une doctrine spécifique au jeu.

Signaux d'alarme (STOP)

PenséeRéalité
"C'est rouge, alors copie la valeur de gauche."Le rouge est une invitation à inspecter. Ce n'est pas un verdict que la valeur perdante devrait survivre.
"Le mod le plus à droite est faux ; je vais l'éditer directement."Alors vous avez fait du mod source le correctif. Utilisez un correctif d'écrasement séparé pour que l'inversion soit propre.
"Le tri n'a pas d'importance car xEdit peut tout corriger."En principe, oui ; sur des centaines de milliers de FormID, non. Utilisez le tri pour réduire la dette de réparation, puis corrigez le reste significatif.
"Les valeurs copiées vertes/inchangées sont inoffensives."Ce sont des marchandises sans intention. Si elles ne changent pas de sens, supprimez-les.
"L'ESL natif est plus propre que l'ESP marqué ESL."L'ESL/ESM natif peut coûter la liberté de tri normale. Utilisez l'ESP marqué ESL lorsque c'est la forme de correctif sûre.
"Cela semble inutilisé ; supprimez-le."Référencé-par d'abord. La suppression sans connaissance de la référence est un rayon d'impact inconnu.

Rationalisations

ExcuseRéalité
"Je vais juste glisser un champ dans le plugin gagnant."Un champ est toujours une édition de mod source. Créez une couche de correctif, ou le vous futur supprimera manuellement les champs égarés un par un.
"Le correctif devrait préserver tout ce qu'un mod a touché."Préservez l'intention, pas l'historique. Certaines modifications sont essentielles au mod ; d'autres sont une préférence d'auteur accessoire qui devrait perdre face à une règle systémique.
"Je ne sais pas ce que fait ce champ, donc je vais copier la version qui a l'air plausible."Une signification de champ inconnue est une tâche de recherche, pas un coup de dé. Lisez la structure de l'enregistrement, CK/wiki/exemples de la communauté et le comportement réel dans le pack.
"L'écrasement est correct ; MO2 le voit."L'écrasement est un débordement. Un vrai correctif appartient à une couche de mod gérée avec un nom que le vous futur peut comprendre.
"La réponse a dit ok ; le correctif est terminé."L'acceptation du correctif est la relecture de l'écrasement gagnant après sauvegarde/redémarrage, avec les valeurs intentionnelles visibles et aucun cargo involontaire.

Vérifications de capacités de divulgation progressive r6

Ne supposez pas que chaque démon est r6. Lisez xedit_list_capabilities une fois et bifurquez sur les clés de support ci-dessous. Sur les démons pré-r6, revenez aux anciens modèles explicites de liste d'enregistrements/parcours enfant/boucle par enregistrement ; sur les démons r6+, utilisez le formulaire à un appel ou conscient de la page pour réduire les allers-retours et préserver le contexte.

Clé de capacitéContratPréférez ce modèleEnregistrement KB
supports.childGroupNavigation0.13Naviguer dans les groupes enfants CELL/WRLD/DIAL/QUST via les souches elements.childrenxedit.childgroup-navigation.v1
supports.createParentSpec0.16 / 0.18Créer des enregistrements directement sous les groupes enfants parents avec records.create parentxedit.records-create-parent-spec.v1
supports.elementsChildrenPagination0.17Paginer elements.children avec limit / offsetxedit.elements-children-pagination.v1
supports.reverseNavigation0.19Ajouter includeParents:true et lire relations.parentsxedit.reverse-navigation.v1

Pour l'ensemble du delta du contrat r6, interrogez l'enregistrement KB xedit.r6-contract-summary.v1.

Navigation dans les groupes enfants (supports.childGroupNavigation)

Sur les démons r6+, elements.children sur les enregistrements CELL, WRLD, DIAL et QUST renvoie une entrée enfant virtuelle avec kind: "child_group". Traitez cette entrée comme une souche de navigation en lecture seule, pas comme un élément mutable réel.

Utilisez-la une génération à la fois :

elements.children({ file, formId, path: "\\Child Group" })
elements.children({ file, formId, path: "\\Child Group\\Persistent" })
elements.children({ file, formId, path: "\\Child Group\\Temporary" })
elements.children({ file, formId, path: "\\Child Group\\Visible when Distant" })
elements.children({ file, formId, path: "\\Child Group\\Block X, Y" })
elements.children({ file, formId, path: "\\Child Group\\Block X, Y\\Sub-Block M, N" })
  • Parcourez exactement le niveau suivant ; ne demandez pas l'arbre entier quand une page ou une étiquette de groupe enfant suffit.
  • Les chemins \\Child Group... sont synthétiques et EN LECTURE SEULE. Les verbes de mutation doivent utiliser des localisateurs FormID plats ({ file, formId }) ou une spécification records.create.parent ; ne passez pas de chemins de localisateurs synthétiques aux mutateurs.
  • Pour les cellules WRLD, utilisez Persistent ou la route Bloc/Sous-Bloc/coordonnée selon le groupe enfant cible.
  • Référence approfondie : xedit.childgroup-navigation.v1.

Pagination elements.children (supports.elementsChildrenPagination)

Sur les démons r6+, elements.children accepte limit et offset :

elements.children({ file, formId, path, limit: 200, offset: 0 })
  • limit est limité à 1-1000 et par défaut à 200.
  • Les réponses incluent count, total, offset et truncated.
  • Si truncated est vrai, gardez le même limit, ajoutez count à offset, et récupérez la page suivante jusqu'à couverture.
  • Ne supposez pas que les groupes enfants CELL sont petits : la cellule vanilla FO4 00000025 Temporary contient 742 enregistrements.
  • Référence approfondie : xedit.elements-children-pagination.v1.

Navigation inverse (supports.reverseNavigation)

Sur les démons r6+, ajoutez includeParents: true lorsque vous avez besoin de connaître la propriété ou le confinement sans un deuxième verbe. Les appels de lecture pris en charge incluent :

  • records.get
  • records.find_by_form_id / records.find_by_editor_id et les wrappers MCP tels que xedit_find_record
  • records.master_or_self
  • records.winning_override
  • elements.get
  • elements.children

La réponse peut inclure :

relations.parents: [{ locator, object }, ...]

Les parents sont les plus proches en premier avec une limite de profondeur de démon de 16. C'est la réponse préférée à "quelle CELL possède ce REFR?" ou "quel groupe QUST/DIAL contient cet enfant?" Utilisez la chaîne parent comme preuve de relecture ; ne construisez pas une boucle d'index inverse personnalisée sauf si la clé de support est absente. Référence approfondie : xedit.reverse-navigation.v1.

Spécification parent records.create (supports.createParentSpec)

La création d'enregistrements mutables dans les groupes enfants est verrouillée par r6 et nécessite toujours le chemin normal de consentement de mutation MCP. Lorsqu'elle est prise en charge, spécifiez le parent cible explicitement au lieu d'essayer de muter des chemins \\Child Group synthétiques.

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

hashgraph-online/awesome-codex-plugins

Explicit landing-page build and deploy operator. Loads marketing and frontend judgment, scaffolds the smallest suitable site, verifies it rendered, deploys to the configured target.

hashgraph-online/awesome-codex-plugins

Use when the user's video is on disk - VidSeeds MCP probe, frame/clip extraction, ffmpeg recipes, precision trim, and midroll analysis. Hosted tools return commands/recipes to run locally; media stays on the user's machine.

hashgraph-online/awesome-codex-plugins

Show or change the Cassette editing model and thinking level for the current media session. Invoke only when the user explicitly asks for the model picker, wants to inspect the current Cassette model, or requests a model/thinking change.

hashgraph-online/awesome-codex-plugins

Edit, trim, cut, caption, subtitle, reframe, combine, add background music to, or export video, audio, and image files through Cassette. Use this skill whenever the user asks to change, preview, or render a media file in the project — even if they never say "Cassette" or name a tool — for example "trim the intro off demo.mp4", "add subtitles to this clip", "make me a 30-second cut with music", "why is there dead air at the start". Drives the local Oh My Cassette stdio MCP tools in Codex or Claude as one multi-turn conversation with the Cassette agent, with per-turn timeline previews, guided questions, and rendering only on explicit export.

hashgraph-online/awesome-codex-plugins

Build reusable Manim explainers for technical concepts, graphs, system diagrams, and product walkthroughs, then hand off to the wider ECC video stack if needed. Use when the user wants a clean animated explainer rather than a generic talking-head script.

hashgraph-online/awesome-codex-plugins

Best practices for Remotion - Video creation in React. 29 domain-specific rules covering 3D, animations, audio, captions, charts, transitions, and more.

hashgraph-online/awesome-codex-plugins

Audit a landing page across six conversion dimensions — above-fold clarity, trust signals, form friction, message match against the upstream ad or email, page speed, and mobile experience — each scored 1-10, rolled into an overall score benchmarked against industry averages, with the top 5 fixes ranked by expected conversion impact. Assessment and recommendations only; it does not edit the page. Triggers on \"/digital-marketing-pro:landing-page-audit\", \"audit this landing page\", \"why isn't this page converting\", \"score our signup page\", \"does the page match the ad copy\". Reads the brand profile, guidelines, custom templates, and agency SOPs before scoring.

hashgraph-online/awesome-codex-plugins

Use when you need a single-pane cross-repo health view across all vault-registered GitLab and GitHub projects. Discovers repos from `_overview.md` frontmatter in `<vault>/01-projects/*/`, aggregates open issues, MRs, critical labels, and stale signals via parallel `glab`/`gh` calls, then writes an idempotent `_PORTFOLIO.md` dashboard. Runs automatically at session-start Phase 2 when `gitlab-portfolio.enabled=true`. Triggers: "show portfolio status", "refresh the portfolio dashboard", "which repos have critical issues", "run /portfolio". <example>Context: session-start, gitlab-portfolio.enabled=true, vault has 5 registered repos. user: "/session deep" assistant: "Portfolio: 3 critical issues across 2 repos — run /portfolio for details. Dashboard written to vault/01-projects/_PORTFOLIO.md."</example>

hashgraph-online/awesome-codex-plugins

Aggregate cross-repo issue/MR/CI health across vault-registered projects into a single Markdown dashboard

hashgraph-online/awesome-codex-plugins

Inspect all configured fantasy teams, saved players, lineup analysis, and transaction proposals through the portfolio MCP. Open the local dashboard for visual review and exact proposal approval.

hashgraph-online/awesome-codex-plugins

Use when building, reviewing, or refactoring a Remotion project, especially parameterized launch or demo videos with shared props schemas, calculateMetadata, Sequence and Series timing, multiple aspect ratios, terminal or footage layers, and render scripts. Prefer official Remotion docs or MCP for API details because package behavior may change.

Skills associés