[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6JTF7NTAQ7E8VBNXDB9CMMV":3,"skill-same:01M6JTF7NTAQ7E8VBNXDB9CMMV":70},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":41,"linkOnly":42,"markdownContent":43,"markdownBody":44,"frontMatter":45,"refName":46,"commitSha":47,"skillDirectory":48,"forksCount":49,"repositoryHtmlUrl":50,"repositoryHomepageUrl":51,"ownerHtmlUrl":52,"ownerBlogUrl":53,"ownerDescription":54,"updatedAt":55,"install":56,"resources":69},"01M6JTF7NTAQ7E8VBNXDB9CMMV","interpreting-mod-author-instructions",null,"Use when deciding how to correctly download\u002Finstall a Bethesda mod per the author's instructions — triggers \"how do I install\", \"FOMOD choices\", \"which file to download\", \"author说明\", \"install instructions\", \"which variant\", \"按作者说明安装\", \"这个mod怎么装\". NOT for deciding whether to include the mod (use evaluating-bgs-mods), load order editing (writing-bgs-load-order), record conflicts (xedit-conflict-audit), archive operations (using-bgs-archive), Papyrus work (using-bgs-papyrus), or translation\u002Fexport tasks (using-bgs-translator).","hashgraph-online\u002Fawesome-codex-plugins","hashgraph-online","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F160371962?v=4","01M6CNB6NRJVNNGN14TR01Q6D3","HOL (Hashgraph Online)","01M6JT1HSKKG9V68KQAQGBA7XP",1575,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FBB-84C\u002Fbgs-modding-superpowers\u002Fskills\u002Finterpreting-mod-author-instructions\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40],"author","interpreting mod author instructions","instructions","translation","when","variant","for","which","mods","how to","conflict","do","writing","conflicts","export","install","editing","work","translator","how","audit","tasks","2026-11-10 10:12:30",false,"---\nname: interpreting-mod-author-instructions\ndescription: Use when deciding how to correctly download\u002Finstall a Bethesda mod per the author's instructions — triggers \"how do I install\", \"FOMOD choices\", \"which file to download\", \"author说明\", \"install instructions\", \"which variant\", \"按作者说明安装\", \"这个mod怎么装\". NOT for deciding whether to include the mod (use evaluating-bgs-mods), load order editing (writing-bgs-load-order), record conflicts (xedit-conflict-audit), archive operations (using-bgs-archive), Papyrus work (using-bgs-papyrus), or translation\u002Fexport tasks (using-bgs-translator).\n---\n\n# Interpreting Mod Author Instructions (judgment skill)\n\nThis skill answers one question only: **How do I correctly download\u002Finstall per the mod author's instructions?** It starts after `evaluating-bgs-mods` has said INCLUDE or CONDITIONAL INCLUDE. The job is not to decide whether the mod is good; the job is to read the author's说明 until the install path, file choice, prerequisite order, option logic, and consequences are actually understood.\n\n## The Iron Law\n\n```text\n+-----------------------------------------------------------------------------------------------+\n| No author说明, no install plan: understand the author's requirements, variants, and consequences |\n| before touching downloads, FOMOD options, files, profiles, or load-order state.                 |\n+-----------------------------------------------------------------------------------------------+\n```\n\n## Route gate (one primary skill per intent)\n\nUse this skill when the user is asking **how to install a mod that is already worth considering**: which file to download, which variant to choose, how to read a FOMOD, what prerequisites must be present first, how to name\u002Ftrack the installed components, or what the author means by a warning.\n\nDo **not** use this skill as the primary skill for adjacent intents:\n\n| User intent | Primary skill |\n|---|---|\n| \"Should I add this mod?\" \u002F quality, risk, fit, pack-value before install | `evaluating-bgs-mods` |\n| Edit, enable, disable, sort, or reason about `plugins.txt` \u002F load order | `writing-bgs-load-order` |\n| Inspect actual records, winners, overrides, or conflict severity | `xedit-conflict-audit` |\n| Extract, inspect, or repack BA2\u002FBSA archives | `using-bgs-archive` |\n| Compile\u002Fdecompile Papyrus PSC\u002FPEX | `using-bgs-papyrus` |\n| Translate plugin text or emit SST\u002FXML dictionaries | `using-bgs-translator` |\n\nUpstream gate: `evaluating-bgs-mods`. Inclusion says \"worth considering\"; it does not grant permission to install by habit.\n\nTerminal handoff target: **NONE**. This skill ends with an install interpretation: selected file(s), selected option(s), prerequisite order, naming\u002Ftracking notes, and open gaps. If follow-on work requires archive\u002FPapyrus\u002Ftranslator\u002Ftool operations, route to the existing tool skill for that operation.\n\n## When to use \u002F When NOT\n\nUse when:\n\n- The user asks \"how do I install this\", \"which file do I download\", \"which variant\", \"FOMOD choices\", \"author说明\", \"按作者说明安装\", or \"what do these install instructions mean\".\n- A mod page has multiple main files, optional files, compatibility patches, translations, or version\u002Fruntime variants.\n- A FOMOD or installer offers choices whose consequences need interpretation against the pack and current environment.\n- The author lists prerequisites, warnings, uninstall notes, tool steps, or compatibility notes that must be converted into an install plan.\n- A downloaded archive or installed mod has vague naming and needs traceable local naming before it becomes future debugging debt.\n\nDo not use when:\n\n- The real question is whether the mod belongs in the pack at all. Use `evaluating-bgs-mods` first.\n- The user is asking to actually perform the installation through MO2 tooling. Use the MO2\u002Fcontrol-plane surface after this interpretation, not this skill as a mutator.\n- The question is load order, plugin activation, or xEdit patching after install.\n- The question is a game-specific engine fact. Query KB instead of fossilizing it here.\n- You are tempted to substitute a generic \"install normally\" checklist for the author's actual instructions.\n\n## Process Flow\n\n```dot\ndigraph interpreting_mod_author_instructions {\n  rankdir=TB;\n  node [shape=box];\n\n  start [shape=doublecircle, label=\"Install-intent question\\n(after INCLUDE \u002F CONDITIONAL INCLUDE)\"];\n  upstream [shape=diamond, label=\"Has evaluating-bgs-mods\\naccepted this mod?\"];\n  route_back [shape=doublecircle, label=\"Route upstream to\\nevaluating-bgs-mods\"];\n  read_page [label=\"Read author page fully\\ndescription, files, requirements, changelog, warnings\"];\n  no_docs [shape=diamond, label=\"Enough author说明\\nto assess install risk?\"];\n  stop_no_docs [shape=doublecircle, label=\"STOP\\nNo install plan; ask for source\u002Fpage or reject install\"];\n  query_kb [label=\"Query KB for game\u002Fruntime\u002Ftool facts\\nrequirements, FOMOD, archive, script, load-order hazards\"];\n  file_matrix [label=\"Build file\u002Fvariant matrix\\nmain, optional, patch, translation, runtime\u002Fgame version\"];\n  prereqs [label=\"Sequence prerequisites\\nmasters, frameworks, tools, assets before dependents\"];\n  options [label=\"Interpret FOMOD\u002Fmanual choices\\nchoose by author meaning + current pack state\"];\n  traceability [label=\"Name and classify components\\nmain vs patch vs translation; preserve source link\"];\n  gaps [shape=diamond, label=\"Any unresolved warning\\nor ambiguous option?\"];\n  ask [shape=doublecircle, label=\"Ask one focused blocker question\\nwith recommended default\"];\n  output [shape=doublecircle, label=\"Install interpretation complete\\nfiles + options + order + notes\"];\n\n  start -> upstream;\n  upstream -> route_back [label=\"no \u002F unclear\"];\n  upstream -> read_page [label=\"yes\"];\n  read_page -> no_docs;\n  no_docs -> stop_no_docs [label=\"no\"];\n  no_docs -> query_kb [label=\"yes\"];\n  query_kb -> file_matrix -> prereqs -> options -> traceability -> gaps;\n  gaps -> ask [label=\"yes\"];\n  gaps -> output [label=\"no\"];\n}\n```\n\n## KB query discipline\n\nThis skill carries the cross-game interpretation framework. It does **not** inline game-specific facts about a specific runtime branch, script extender, archive format, FOMOD convention, or plugin limit. Query the KB for the current game and mod type before turning an instruction into an install decision.\n\nUse at least these query shapes when relevant:\n\n```text\nbgs_kb_query({\n  query: \"author instruction install signals FOMOD variants requirements\",\n  domains: [\"install-planning\"],\n  games: [\"\u003Ccurrent game>\"]\n})\n\nbgs_kb_query({\n  query: \"\u003Cmod type> install requirements compatibility patches prerequisites\",\n  domains: [\"install-planning\", \"load-order\", \"archive-precedence\", \"papyrus\"],\n  games: [\"\u003Ccurrent game>\"]\n})\n```\n\n[STOP] If you are about to write a game-specific install rule into this file, STOP — it belongs in a KB record. This skill may say \"query for the current runtime and requirement facts\"; it must not fossilize one game's current toolchain or one mod page's FOMOD choices.\n\n## Checklist\n\n1. Confirm the upstream gate: the mod has already passed `evaluating-bgs-mods` as INCLUDE or CONDITIONAL INCLUDE. If not, route upstream.\n2. Read the original author page\u002Fsource first when available. Rehosted files without说明 are not enough.\n3. Read the author说明 fully, including requirements, file descriptions, compatibility notes, changelog warnings, uninstall notes, and installer option text.\n4. If the说明 is in another language, translate it. Skipping because it is long or English is not acceptable.\n5. If no author说明 exists, stop by default. Ask for the original page\u002Fsource or decline to form an install plan.\n6. Query KB for game-specific operational facts before applying a variant, runtime, archive, script, or plugin assumption.\n7. Build a file matrix: main file(s), optional file(s), patches, translations, asset packs, old files, update-only files, and mutually exclusive variants.\n8. Choose variants from author meaning plus current pack state, not from filename vibes, popularity, or whatever the installer preselected.\n9. Sequence prerequisites before dependents: required masters\u002Fframeworks\u002Fassets\u002Ftools first, then the mod, then optional patches\u002Ftranslations as instructed.\n10. For FOMOD\u002Fmanual choices, record what was selected and why in terms the future maintainer can audit.\n11. Rename and classify installed components so ownership is obvious: main file, compatibility patch, translation, or tool\u002Foutput component.\n12. Preserve a path back to the author page\u002Fsource so future debugging can re-read the instructions.\n13. If an instruction requires an adjacent tool operation, hand off to the exact tool skill for that operation after this interpretation.\n14. If one ambiguity remains, ask one focused blocker question with a recommended default; do not invent an install path.\n\n## Red Flags (STOP)\n\n| Thought | Reality |\n|---|---|\n| \"No description probably means normal install.\" | No说明 means risk cannot be assessed. Stop or find the original source. |\n| \"The file mirror has the archive, so the page doesn't matter.\" | The page is the install surface; files alone lose requirements and consequences. |\n| \"The FOMOD default is probably right.\" | Defaults are not pack-aware. Read option text and author notes. |\n| \"I can choose the variant from the filename.\" | Variant names are clues, not instructions. Confirm game\u002Fruntime\u002Fpack requirements. |\n| \"The instructions are English; I'll skim.\" | Translate and read. Language friction is not a waiver. |\n| \"The mod manager will sort it out.\" | Managers execute operations; they do not understand author intent. |\n| \"Patch is a good enough local name.\" | A patch with no owner is future debugging debt. |\n| \"Disable is rollback.\" | Some mods, especially scripted ones, do not cleanly leave an active save. |\n| \"This is install work, so KB is unnecessary.\" | Game\u002Fruntime facts live in KB; the skill is deliberately game-agnostic. |\n\n## Rationalizations\n\n| Excuse | Reality |\n|---|---|\n| \"I already decided the mod is good, so install is routine.\" | Inclusion answers worth; install still has file, option, prerequisite, and consequence decisions. |\n| \"I'll download every optional file and sort it later.\" | Optional files often encode mutually exclusive variants or patch stacks. Build the matrix first. |\n| \"I'll install first and read if something breaks.\" | Reading is the install step that prevents preventable breakage. |\n| \"I remember what this patch is for.\" | Future-you forgets. Name and classify now. |\n| \"The author says use a tool; I'll improvise the tool step.\" | Interpret the required operation, then route to the tool skill that owns it. |\n| \"The comments say another variant works better.\" | Comments are clues; author instructions and current-game KB facts carry the plan. |\n| \"This is just a translation\u002Fasset\u002Foptional file.\" | Optional components still change ownership, conflict surfaces, and uninstall behavior. |\n| \"A generic install checklist is faster.\" | BB84's point is not checklist compliance; it is active reading and consequence awareness. |\n\n## Recommended Approach: Senior Curator's Lens\n\n> This section reflects an experienced curator's perspective, distilled from BB84's\n> BGS modpack curation work. It is RECOMMENDED guidance, **not enforced rule**.\n> If the user has explicit alternative intent (different install policy, different\n> risk tolerance, or pack-specific convention), the agent SHOULD adapt rather than\n> push these defaults. The objective rules in this skill body still apply.\n\nRecommended author-instruction lens:\n\n1. **Honest detailed instructions = green flag.** Author who lists prerequisites,\n   conflicts, version compatibility, FOMOD option meanings, and known issues\n   earns trust. Curt or evasive instructions earn skepticism.\n2. **Patreon-locked main version or essential patches = red flag.** Walls\n   critical content behind paywall while expecting community patches; structurally\n   breaks the community patch ecosystem.\n\nSee KB record `mod-evaluation.author-signals` (KB) and\n`mod-evaluation.bb84-curator-perspective-reference` for full curator essay.\n\n## Investigating Nexus mods marked not_published \u002F hidden \u002F removed\n\nWhen the agent or a MO2 refresh reports a mod as `status=not_published`, `status=hidden`, or `status=removed`, do NOT default to \"disable + find replacement\". The priority investigation order:\n\n1. **Author republish check** (highest yield) — fetch original mod's `author` + `user.member_id`; search Nexus for the same mod name; visit author's profile; confirm candidate new modid has the same `user.member_id`. Modders sometimes restart with a fresh modid instead of updating in place. The \"dead\" listing is just abandoned.\n2. **Author continuation off-Nexus** — GitHub source, Patreon, Discord.\n3. **Third-party maintenance fork** — Nexus search for `\"\u003Cmod name>\" continued \u002F updated \u002F patched`. Beware permission ambiguity.\n4. **Alternative implementation** — different author, possibly different approach (e.g., perk-based instead of SFSE-plugin-based).\n\nAfter finding the answer:\n\n- If author republished: update MO2 mod folder's `meta.ini` `modid=` and `installationFile=` to the new listing. Otherwise Option B refresh forever reports `not_published`.\n- If switched to alternative: backup old mod folder, disable in modlist.txt with `[弃用]` separator convention.\n- ALWAYS record the investigation in `docs\u002Fdev-log.md` so half-year-later \"why did we switch X to Y?\" is answerable.\n\nCross-link: KB record `mod-evaluation.investigating-pulled-mods.v1` for the full pattern with example cases.\n\n## Comprehensive file enumeration and cross-reference (rigor discipline)\n\nAuthors organize files into categories to communicate intent. Reading only the\nMain file's description is the most common shallow-investigation pattern, and\nit skips the half of the curator's work that actually matters.\n\nFor every mod install or update, enumerate the FULL file listing under all\nvisible Nexus file categories:\n\n- **Main** — current canonical builds. Often more than one. The variants encode\n  game-runtime support (SFSE vs GamePass ASI), feature flags (with\u002Fwithout\n  module X), color\u002Fsize choices, fork lineages, and required-vs-optional\n  prerequisites. Surface every variant to the curator with the differentiator\n  named.\n- **Optional** — compatibility patches and add-ons. Each carries a description\n  identifying which other mod it patches and what game systems it touches.\n  Walk this list one file at a time.\n- **Update** — incremental patches against an earlier Main file. Usually\n  require the Main file as prerequisite; do not install Update files standalone\n  without verifying.\n- **Archived \u002F Old** — superseded versions. Do not install from this category\n  by default; it exists for historical fallback, not as the recommended target.\n\nFor each Optional file the author lists:\n\n1. Read the file description fully — what mod does it patch? What feature does\n   it enable? Are there prerequisites listed?\n2. Cross-reference the patched-mod claim against the curator's installed\n   environment:\n   - `\u003CMO2Root>\u002Fprofiles\u002F\u003Cprofile>\u002Fmodlist.txt` — enabled (`+`) AND disabled\n     (`-`) mods both count; the curator may re-enable a disabled CC mod and\n     then need the patch installed.\n   - `\u003CMO2Root>\u002Fprofiles\u002F\u003Cprofile>\u002Fplugins.txt` — active (`*`) plugins.\n   - The actual `\u003CMO2Root>\u002Fmods\u002F\u003Cmodname>\u002F` folder list — sometimes a mod is\n     present but not yet active.\n3. Classify the patch as `install` (curator has the patched mod), `skip`\n   (curator does not have the patched mod and is unlikely to install it), or\n   `surface-to-curator` (ambiguous case where curator should decide).\n\nWhen variants exist within a single category (e.g. Main has a 1k texture build\nand a 2k texture build), do not auto-pick. Surface the variant set to the\ncurator with the differentiator named, the trade-off summarized, and the\nrecommended default highlighted. The curator decides.\n\nConcrete illustrations:\n\n- Stroud Premium Edition (Nexus #12330) main 2.5.3 file ships with four\n  Optional files: `AddOn - SPE x TerranArmada`, `Patch SPE x Useful MessHalls`,\n  `Patch SPE x Useful Infirmaries`, `AddOn - SPE x Deimog`. For a curator who\n  has Terran Armada DLC and Useful Infirmaries CC mod, the first two of those\n  four are install-relevant. The other two are skips because the curator does\n  not have MessHalls or Deimog. Recommending all four wastes the curator's\n  time; recommending only the main without enumerating the four wastes\n  compatibility benefit.\n- Starfield Shader Injector (Nexus #5562) main category lists two\n  simultaneously-uploaded files: `SSI-1_10 (GamePassASI-1_16_236)` and\n  `SSI-1_10 (SFSE-1_16_236)`. Same version, different runtime. Curator-pick on\n  Steam vs Game Pass; never auto-install both.\n\nThe corresponding KB record `install-planning.audit-workflow-rigor.v1` defines\nthis as one of six audit-grade rigor disciplines.\n\n## See also\n\n- `evaluating-bgs-mods` — upstream judgment: decides whether the mod belongs in the pack before this skill interprets installation.\n- `writing-bgs-load-order` — plugin enablement, `plugins.txt`, load-order, and sorting mechanics after install planning.\n- `xedit-conflict-audit` — record-level conflict and winning-override inspection.\n- `using-bgs-archive` — BA2\u002FBSA inspection, extraction, and overlay-safe archive work when the author's instructions require asset operations.\n- `using-bgs-papyrus` — PSC\u002FPEX compile\u002Fdecompile when author instructions require script work.\n- `using-bgs-translator` — plugin text translation and SST\u002FXML export when author instructions require localization work.\n- `bgs_kb_query` — required source for game-specific install facts, runtime hazards, and operational conventions.\n","# Interpreting Mod Author Instructions (judgment skill)\n\nThis skill answers one question only: **How do I correctly download\u002Finstall per the mod author's instructions?** It starts after `evaluating-bgs-mods` has said INCLUDE or CONDITIONAL INCLUDE. The job is not to decide whether the mod is good; the job is to read the author's说明 until the install path, file choice, prerequisite order, option logic, and consequences are actually understood.\n\n## The Iron Law\n\n```text\n+-----------------------------------------------------------------------------------------------+\n| No author说明, no install plan: understand the author's requirements, variants, and consequences |\n| before touching downloads, FOMOD options, files, profiles, or load-order state.                 |\n+-----------------------------------------------------------------------------------------------+\n```\n\n## Route gate (one primary skill per intent)\n\nUse this skill when the user is asking **how to install a mod that is already worth considering**: which file to download, which variant to choose, how to read a FOMOD, what prerequisites must be present first, how to name\u002Ftrack the installed components, or what the author means by a warning.\n\nDo **not** use this skill as the primary skill for adjacent intents:\n\n| User intent | Primary skill |\n|---|---|\n| \"Should I add this mod?\" \u002F quality, risk, fit, pack-value before install | `evaluating-bgs-mods` |\n| Edit, enable, disable, sort, or reason about `plugins.txt` \u002F load order | `writing-bgs-load-order` |\n| Inspect actual records, winners, overrides, or conflict severity | `xedit-conflict-audit` |\n| Extract, inspect, or repack BA2\u002FBSA archives | `using-bgs-archive` |\n| Compile\u002Fdecompile Papyrus PSC\u002FPEX | `using-bgs-papyrus` |\n| Translate plugin text or emit SST\u002FXML dictionaries | `using-bgs-translator` |\n\nUpstream gate: `evaluating-bgs-mods`. Inclusion says \"worth considering\"; it does not grant permission to install by habit.\n\nTerminal handoff target: **NONE**. This skill ends with an install interpretation: selected file(s), selected option(s), prerequisite order, naming\u002Ftracking notes, and open gaps. If follow-on work requires archive\u002FPapyrus\u002Ftranslator\u002Ftool operations, route to the existing tool skill for that operation.\n\n## When to use \u002F When NOT\n\nUse when:\n\n- The user asks \"how do I install this\", \"which file do I download\", \"which variant\", \"FOMOD choices\", \"author说明\", \"按作者说明安装\", or \"what do these install instructions mean\".\n- A mod page has multiple main files, optional files, compatibility patches, translations, or version\u002Fruntime variants.\n- A FOMOD or installer offers choices whose consequences need interpretation against the pack and current environment.\n- The author lists prerequisites, warnings, uninstall notes, tool steps, or compatibility notes that must be converted into an install plan.\n- A downloaded archive or installed mod has vague naming and needs traceable local naming before it becomes future debugging debt.\n\nDo not use when:\n\n- The real question is whether the mod belongs in the pack at all. Use `evaluating-bgs-mods` first.\n- The user is asking to actually perform the installation through MO2 tooling. Use the MO2\u002Fcontrol-plane surface after this interpretation, not this skill as a mutator.\n- The question is load order, plugin activation, or xEdit patching after install.\n- The question is a game-specific engine fact. Query KB instead of fossilizing it here.\n- You are tempted to substitute a generic \"install normally\" checklist for the author's actual instructions.\n\n## Process Flow\n\n```dot\ndigraph interpreting_mod_author_instructions {\n  rankdir=TB;\n  node [shape=box];\n\n  start [shape=doublecircle, label=\"Install-intent question\\n(after INCLUDE \u002F CONDITIONAL INCLUDE)\"];\n  upstream [shape=diamond, label=\"Has evaluating-bgs-mods\\naccepted this mod?\"];\n  route_back [shape=doublecircle, label=\"Route upstream to\\nevaluating-bgs-mods\"];\n  read_page [label=\"Read author page fully\\ndescription, files, requirements, changelog, warnings\"];\n  no_docs [shape=diamond, label=\"Enough author说明\\nto assess install risk?\"];\n  stop_no_docs [shape=doublecircle, label=\"STOP\\nNo install plan; ask for source\u002Fpage or reject install\"];\n  query_kb [label=\"Query KB for game\u002Fruntime\u002Ftool facts\\nrequirements, FOMOD, archive, script, load-order hazards\"];\n  file_matrix [label=\"Build file\u002Fvariant matrix\\nmain, optional, patch, translation, runtime\u002Fgame version\"];\n  prereqs [label=\"Sequence prerequisites\\nmasters, frameworks, tools, assets before dependents\"];\n  options [label=\"Interpret FOMOD\u002Fmanual choices\\nchoose by author meaning + current pack state\"];\n  traceability [label=\"Name and classify components\\nmain vs patch vs translation; preserve source link\"];\n  gaps [shape=diamond, label=\"Any unresolved warning\\nor ambiguous option?\"];\n  ask [shape=doublecircle, label=\"Ask one focused blocker question\\nwith recommended default\"];\n  output [shape=doublecircle, label=\"Install interpretation complete\\nfiles + options + order + notes\"];\n\n  start -> upstream;\n  upstream -> route_back [label=\"no \u002F unclear\"];\n  upstream -> read_page [label=\"yes\"];\n  read_page -> no_docs;\n  no_docs -> stop_no_docs [label=\"no\"];\n  no_docs -> query_kb [label=\"yes\"];\n  query_kb -> file_matrix -> prereqs -> options -> traceability -> gaps;\n  gaps -> ask [label=\"yes\"];\n  gaps -> output [label=\"no\"];\n}\n```\n\n## KB query discipline\n\nThis skill carries the cross-game interpretation framework. It does **not** inline game-specific facts about a specific runtime branch, script extender, archive format, FOMOD convention, or plugin limit. Query the KB for the current game and mod type before turning an instruction into an install decision.\n\nUse at least these query shapes when relevant:\n\n```text\nbgs_kb_query({\n  query: \"author instruction install signals FOMOD variants requirements\",\n  domains: [\"install-planning\"],\n  games: [\"\u003Ccurrent game>\"]\n})\n\nbgs_kb_query({\n  query: \"\u003Cmod type> install requirements compatibility patches prerequisites\",\n  domains: [\"install-planning\", \"load-order\", \"archive-precedence\", \"papyrus\"],\n  games: [\"\u003Ccurrent game>\"]\n})\n```\n\n[STOP] If you are about to write a game-specific install rule into this file, STOP — it belongs in a KB record. This skill may say \"query for the current runtime and requirement facts\"; it must not fossilize one game's current toolchain or one mod page's FOMOD choices.\n\n## Checklist\n\n1. Confirm the upstream gate: the mod has already passed `evaluating-bgs-mods` as INCLUDE or CONDITIONAL INCLUDE. If not, route upstream.\n2. Read the original author page\u002Fsource first when available. Rehosted files without说明 are not enough.\n3. Read the author说明 fully, including requirements, file descriptions, compatibility notes, changelog warnings, uninstall notes, and installer option text.\n4. If the说明 is in another language, translate it. Skipping because it is long or English is not acceptable.\n5. If no author说明 exists, stop by default. Ask for the original page\u002Fsource or decline to form an install plan.\n6. Query KB for game-specific operational facts before applying a variant, runtime, archive, script, or plugin assumption.\n7. Build a file matrix: main file(s), optional file(s), patches, translations, asset packs, old files, update-only files, and mutually exclusive variants.\n8. Choose variants from author meaning plus current pack state, not from filename vibes, popularity, or whatever the installer preselected.\n9. Sequence prerequisites before dependents: required masters\u002Fframeworks\u002Fassets\u002Ftools first, then the mod, then optional patches\u002Ftranslations as instructed.\n10. For FOMOD\u002Fmanual choices, record what was selected and why in terms the future maintainer can audit.\n11. Rename and classify installed components so ownership is obvious: main file, compatibility patch, translation, or tool\u002Foutput component.\n12. Preserve a path back to the author page\u002Fsource so future debugging can re-read the instructions.\n13. If an instruction requires an adjacent tool operation, hand off to the exact tool skill for that operation after this interpretation.\n14. If one ambiguity remains, ask one focused blocker question with a recommended default; do not invent an install path.\n\n## Red Flags (STOP)\n\n| Thought | Reality |\n|---|---|\n| \"No description probably means normal install.\" | No说明 means risk cannot be assessed. Stop or find the original source. |\n| \"The file mirror has the archive, so the page doesn't matter.\" | The page is the install surface; files alone lose requirements and consequences. |\n| \"The FOMOD default is probably right.\" | Defaults are not pack-aware. Read option text and author notes. |\n| \"I can choose the variant from the filename.\" | Variant names are clues, not instructions. Confirm game\u002Fruntime\u002Fpack requirements. |\n| \"The instructions are English; I'll skim.\" | Translate and read. Language friction is not a waiver. |\n| \"The mod manager will sort it out.\" | Managers execute operations; they do not understand author intent. |\n| \"Patch is a good enough local name.\" | A patch with no owner is future debugging debt. |\n| \"Disable is rollback.\" | Some mods, especially scripted ones, do not cleanly leave an active save. |\n| \"This is install work, so KB is unnecessary.\" | Game\u002Fruntime facts live in KB; the skill is deliberately game-agnostic. |\n\n## Rationalizations\n\n| Excuse | Reality |\n|---|---|\n| \"I already decided the mod is good, so install is routine.\" | Inclusion answers worth; install still has file, option, prerequisite, and consequence decisions. |\n| \"I'll download every optional file and sort it later.\" | Optional files often encode mutually exclusive variants or patch stacks. Build the matrix first. |\n| \"I'll install first and read if something breaks.\" | Reading is the install step that prevents preventable breakage. |\n| \"I remember what this patch is for.\" | Future-you forgets. Name and classify now. |\n| \"The author says use a tool; I'll improvise the tool step.\" | Interpret the required operation, then route to the tool skill that owns it. |\n| \"The comments say another variant works better.\" | Comments are clues; author instructions and current-game KB facts carry the plan. |\n| \"This is just a translation\u002Fasset\u002Foptional file.\" | Optional components still change ownership, conflict surfaces, and uninstall behavior. |\n| \"A generic install checklist is faster.\" | BB84's point is not checklist compliance; it is active reading and consequence awareness. |\n\n## Recommended Approach: Senior Curator's Lens\n\n> This section reflects an experienced curator's perspective, distilled from BB84's\n> BGS modpack curation work. It is RECOMMENDED guidance, **not enforced rule**.\n> If the user has explicit alternative intent (different install policy, different\n> risk tolerance, or pack-specific convention), the agent SHOULD adapt rather than\n> push these defaults. The objective rules in this skill body still apply.\n\nRecommended author-instruction lens:\n\n1. **Honest detailed instructions = green flag.** Author who lists prerequisites,\n   conflicts, version compatibility, FOMOD option meanings, and known issues\n   earns trust. Curt or evasive instructions earn skepticism.\n2. **Patreon-locked main version or essential patches = red flag.** Walls\n   critical content behind paywall while expecting community patches; structurally\n   breaks the community patch ecosystem.\n\nSee KB record `mod-evaluation.author-signals` (KB) and\n`mod-evaluation.bb84-curator-perspective-reference` for full curator essay.\n\n## Investigating Nexus mods marked not_published \u002F hidden \u002F removed\n\nWhen the agent or a MO2 refresh reports a mod as `status=not_published`, `status=hidden`, or `status=removed`, do NOT default to \"disable + find replacement\". The priority investigation order:\n\n1. **Author republish check** (highest yield) — fetch original mod's `author` + `user.member_id`; search Nexus for the same mod name; visit author's profile; confirm candidate new modid has the same `user.member_id`. Modders sometimes restart with a fresh modid instead of updating in place. The \"dead\" listing is just abandoned.\n2. **Author continuation off-Nexus** — GitHub source, Patreon, Discord.\n3. **Third-party maintenance fork** — Nexus search for `\"\u003Cmod name>\" continued \u002F updated \u002F patched`. Beware permission ambiguity.\n4. **Alternative implementation** — different author, possibly different approach (e.g., perk-based instead of SFSE-plugin-based).\n\nAfter finding the answer:\n\n- If author republished: update MO2 mod folder's `meta.ini` `modid=` and `installationFile=` to the new listing. Otherwise Option B refresh forever reports `not_published`.\n- If switched to alternative: backup old mod folder, disable in modlist.txt with `[弃用]` separator convention.\n- ALWAYS record the investigation in `docs\u002Fdev-log.md` so half-year-later \"why did we switch X to Y?\" is answerable.\n\nCross-link: KB record `mod-evaluation.investigating-pulled-mods.v1` for the full pattern with example cases.\n\n## Comprehensive file enumeration and cross-reference (rigor discipline)\n\nAuthors organize files into categories to communicate intent. Reading only the\nMain file's description is the most common shallow-investigation pattern, and\nit skips the half of the curator's work that actually matters.\n\nFor every mod install or update, enumerate the FULL file listing under all\nvisible Nexus file categories:\n\n- **Main** — current canonical builds. Often more than one. The variants encode\n  game-runtime support (SFSE vs GamePass ASI), feature flags (with\u002Fwithout\n  module X), color\u002Fsize choices, fork lineages, and required-vs-optional\n  prerequisites. Surface every variant to the curator with the differentiator\n  named.\n- **Optional** — compatibility patches and add-ons. Each carries a description\n  identifying which other mod it patches and what game systems it touches.\n  Walk this list one file at a time.\n- **Update** — incremental patches against an earlier Main file. Usually\n  require the Main file as prerequisite; do not install Update files standalone\n  without verifying.\n- **Archived \u002F Old** — superseded versions. Do not install from this category\n  by default; it exists for historical fallback, not as the recommended target.\n\nFor each Optional file the author lists:\n\n1. Read the file description fully — what mod does it patch? What feature does\n   it enable? Are there prerequisites listed?\n2. Cross-reference the patched-mod claim against the curator's installed\n   environment:\n   - `\u003CMO2Root>\u002Fprofiles\u002F\u003Cprofile>\u002Fmodlist.txt` — enabled (`+`) AND disabled\n     (`-`) mods both count; the curator may re-enable a disabled CC mod and\n     then need the patch installed.\n   - `\u003CMO2Root>\u002Fprofiles\u002F\u003Cprofile>\u002Fplugins.txt` — active (`*`) plugins.\n   - The actual `\u003CMO2Root>\u002Fmods\u002F\u003Cmodname>\u002F` folder list — sometimes a mod is\n     present but not yet active.\n3. Classify the patch as `install` (curator has the patched mod), `skip`\n   (curator does not have the patched mod and is unlikely to install it), or\n   `surface-to-curator` (ambiguous case where curator should decide).\n\nWhen variants exist within a single category (e.g. Main has a 1k texture build\nand a 2k texture build), do not auto-pick. Surface the variant set to the\ncurator with the differentiator named, the trade-off summarized, and the\nrecommended default highlighted. The curator decides.\n\nConcrete illustrations:\n\n- Stroud Premium Edition (Nexus #12330) main 2.5.3 file ships with four\n  Optional files: `AddOn - SPE x TerranArmada`, `Patch SPE x Useful MessHalls`,\n  `Patch SPE x Useful Infirmaries`, `AddOn - SPE x Deimog`. For a curator who\n  has Terran Armada DLC and Useful Infirmaries CC mod, the first two of those\n  four are install-relevant. The other two are skips because the curator does\n  not have MessHalls or Deimog. Recommending all four wastes the curator's\n  time; recommending only the main without enumerating the four wastes\n  compatibility benefit.\n- Starfield Shader Injector (Nexus #5562) main category lists two\n  simultaneously-uploaded files: `SSI-1_10 (GamePassASI-1_16_236)` and\n  `SSI-1_10 (SFSE-1_16_236)`. Same version, different runtime. Curator-pick on\n  Steam vs Game Pass; never auto-install both.\n\nThe corresponding KB record `install-planning.audit-workflow-rigor.v1` defines\nthis as one of six audit-grade rigor disciplines.\n\n## See also\n\n- `evaluating-bgs-mods` — upstream judgment: decides whether the mod belongs in the pack before this skill interprets installation.\n- `writing-bgs-load-order` — plugin enablement, `plugins.txt`, load-order, and sorting mechanics after install planning.\n- `xedit-conflict-audit` — record-level conflict and winning-override inspection.\n- `using-bgs-archive` — BA2\u002FBSA inspection, extraction, and overlay-safe archive work when the author's instructions require asset operations.\n- `using-bgs-papyrus` — PSC\u002FPEX compile\u002Fdecompile when author instructions require script work.\n- `using-bgs-translator` — plugin text translation and SST\u002FXML export when author instructions require localization work.\n- `bgs_kb_query` — required source for game-specific install facts, runtime hazards, and operational conventions.\n",{"name":5,"description":7},"main","b0f0a87593c578a7898eccaf1b363f7f87c1f99b","plugins\u002FBB-84C\u002Fbgs-modding-superpowers\u002Fskills\u002Finterpreting-mod-author-instructions",491,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins","https:\u002F\u002Fhol.org\u002Fplugins\u002Fbest-codex-plugins","https:\u002F\u002Fgithub.com\u002Fhashgraph-online","https:\u002F\u002Fhol.org","Open-source standards and developer tools for interoperable AI agents: discovery, identity, communication, payments, privacy and security.","2026-11-14 14:06:13",{"source":8,"skillName":5,"commands":57,"prompt":67,"zipAvailable":68},[58,61,64],{"tool":59,"command":60},"npx","npx skills add hashgraph-online\u002Fawesome-codex-plugins --skill interpreting-mod-author-instructions",{"tool":62,"command":63},"bunx","bunx skills add hashgraph-online\u002Fawesome-codex-plugins --skill interpreting-mod-author-instructions",{"tool":65,"command":66},"pnpm","pnpm dlx skills add hashgraph-online\u002Fawesome-codex-plugins --skill interpreting-mod-author-instructions","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FBB-84C\u002Fbgs-modding-superpowers\u002Fskills\u002Finterpreting-mod-author-instructions\u002FSKILL.md",true,[],[71,81,89,97,105,113],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":75,"licenseFileUrl":76,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":80},"01M7DV332YQMGD8WTRJ9DZQXTB","worktable-review-with-annotations","Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.","MIT","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":75,"licenseFileUrl":85,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":80},"01M7DV2YGHCZVBEB1AHYB6CGHE","worktable-find-and-synthesize-context","Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":75,"licenseFileUrl":93,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":80},"01M7DV2TQN1H11ME2SAF9MXN7V","worktable-create-or-update-docs","Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":75,"licenseFileUrl":101,"sourceHtmlUrl":102,"categories":103,"keywords":104,"publishedAt":80},"01M7DV2NE452NEA8TXATKSNAJH","worktable-create-or-manage-records","Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FSKILL.md",[],[],{"skillNo":106,"name":107,"nameZh":6,"description":108,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":75,"licenseFileUrl":109,"sourceHtmlUrl":110,"categories":111,"keywords":112,"publishedAt":80},"01M7DV2HENRBR2KSCVM064WH0Y","worktable-create-or-manage-interactive-html","Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FSKILL.md",[],[],{"skillNo":114,"name":115,"nameZh":6,"description":116,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":75,"licenseFileUrl":117,"sourceHtmlUrl":118,"categories":119,"keywords":120,"publishedAt":80},"01M7DV2CADR5R7RQFFYPNAGR9Y","worktable-collaborate-threads","Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FSKILL.md",[],[]]