interpreting-mod-author-instructions
Use when deciding how to correctly download/install 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怎么装"
Install / Use
npx skills add hashgraph-online/awesome-codex-plugins --skill interpreting-mod-author-instructionsInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Content & MediaSupported Platforms
Tags
Our assessment of interpreting-mod-author-instructions
interpreting-mod-author-instructions scores 91/100 on our quality scale, 373rd of 1,155 Content & Media skills we index (top 33%).
Its SKILL.md is 17 KB long, well organised into 13 sections with 3 code examples: a thorough specification that gives an agent plenty to work with.
With 1,075 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so interpreting-mod-author-instructions is actively maintained.
- Our last check on 2026-10-28 found the source still online.
- It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-07. Automated pattern scan on 2026-10-07. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
interpreting-mod-author-instructions compared with similar skills
All 4 of these similar skills score higher than interpreting-mod-author-instructions; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| interpreting-mod-author-instructions (this skill)by hashgraph-online | 91 | 1.1k | 53d ago | SKILL.md |
| siyuanby siyuan-note | 100 | 47.3k | today | MCP Server |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
Frequently asked questions
- How do I install interpreting-mod-author-instructions?
- Run
npx skills add hashgraph-online/awesome-codex-plugins --skill interpreting-mod-author-instructions. The install tabs above show the steps for each supported agent. - Which AI agents does interpreting-mod-author-instructions work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is interpreting-mod-author-instructions safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is interpreting-mod-author-instructions still maintained?
- The repository was last updated about 2 months ago, so interpreting-mod-author-instructions is actively maintained.
Skill content
View source on GitHubname: interpreting-mod-author-instructions description: Use when deciding how to correctly download/install 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/export tasks (using-bgs-translator).
Interpreting Mod Author Instructions (judgment skill)
This skill answers one question only: How do I correctly download/install 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.
The Iron Law
+-----------------------------------------------------------------------------------------------+
| No author说明, no install plan: understand the author's requirements, variants, and consequences |
| before touching downloads, FOMOD options, files, profiles, or load-order state. |
+-----------------------------------------------------------------------------------------------+
Route gate (one primary skill per intent)
Use 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/track the installed components, or what the author means by a warning.
Do not use this skill as the primary skill for adjacent intents:
| User intent | Primary skill |
|---|---|
| "Should I add this mod?" / quality, risk, fit, pack-value before install | evaluating-bgs-mods |
| Edit, enable, disable, sort, or reason about plugins.txt / load order | writing-bgs-load-order |
| Inspect actual records, winners, overrides, or conflict severity | xedit-conflict-audit |
| Extract, inspect, or repack BA2/BSA archives | using-bgs-archive |
| Compile/decompile Papyrus PSC/PEX | using-bgs-papyrus |
| Translate plugin text or emit SST/XML dictionaries | using-bgs-translator |
Upstream gate: evaluating-bgs-mods. Inclusion says "worth considering"; it does not grant permission to install by habit.
Terminal handoff target: NONE. This skill ends with an install interpretation: selected file(s), selected option(s), prerequisite order, naming/tracking notes, and open gaps. If follow-on work requires archive/Papyrus/translator/tool operations, route to the existing tool skill for that operation.
When to use / When NOT
Use when:
- 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".
- A mod page has multiple main files, optional files, compatibility patches, translations, or version/runtime variants.
- A FOMOD or installer offers choices whose consequences need interpretation against the pack and current environment.
- The author lists prerequisites, warnings, uninstall notes, tool steps, or compatibility notes that must be converted into an install plan.
- A downloaded archive or installed mod has vague naming and needs traceable local naming before it becomes future debugging debt.
Do not use when:
- The real question is whether the mod belongs in the pack at all. Use
evaluating-bgs-modsfirst. - The user is asking to actually perform the installation through MO2 tooling. Use the MO2/control-plane surface after this interpretation, not this skill as a mutator.
- The question is load order, plugin activation, or xEdit patching after install.
- The question is a game-specific engine fact. Query KB instead of fossilizing it here.
- You are tempted to substitute a generic "install normally" checklist for the author's actual instructions.
Process Flow
digraph interpreting_mod_author_instructions {
rankdir=TB;
node [shape=box];
start [shape=doublecircle, label="Install-intent question\n(after INCLUDE / CONDITIONAL INCLUDE)"];
upstream [shape=diamond, label="Has evaluating-bgs-mods\naccepted this mod?"];
route_back [shape=doublecircle, label="Route upstream to\nevaluating-bgs-mods"];
read_page [label="Read author page fully\ndescription, files, requirements, changelog, warnings"];
no_docs [shape=diamond, label="Enough author说明\nto assess install risk?"];
stop_no_docs [shape=doublecircle, label="STOP\nNo install plan; ask for source/page or reject install"];
query_kb [label="Query KB for game/runtime/tool facts\nrequirements, FOMOD, archive, script, load-order hazards"];
file_matrix [label="Build file/variant matrix\nmain, optional, patch, translation, runtime/game version"];
prereqs [label="Sequence prerequisites\nmasters, frameworks, tools, assets before dependents"];
options [label="Interpret FOMOD/manual choices\nchoose by author meaning + current pack state"];
traceability [label="Name and classify components\nmain vs patch vs translation; preserve source link"];
gaps [shape=diamond, label="Any unresolved warning\nor ambiguous option?"];
ask [shape=doublecircle, label="Ask one focused blocker question\nwith recommended default"];
output [shape=doublecircle, label="Install interpretation complete\nfiles + options + order + notes"];
start -> upstream;
upstream -> route_back [label="no / unclear"];
upstream -> read_page [label="yes"];
read_page -> no_docs;
no_docs -> stop_no_docs [label="no"];
no_docs -> query_kb [label="yes"];
query_kb -> file_matrix -> prereqs -> options -> traceability -> gaps;
gaps -> ask [label="yes"];
gaps -> output [label="no"];
}
KB query discipline
This 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.
Use at least these query shapes when relevant:
bgs_kb_query({
query: "author instruction install signals FOMOD variants requirements",
domains: ["install-planning"],
games: ["<current game>"]
})
bgs_kb_query({
query: "<mod type> install requirements compatibility patches prerequisites",
domains: ["install-planning", "load-order", "archive-precedence", "papyrus"],
games: ["<current game>"]
})
[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.
Checklist
- Confirm the upstream gate: the mod has already passed
evaluating-bgs-modsas INCLUDE or CONDITIONAL INCLUDE. If not, route upstream. - Read the original author page/source first when available. Rehosted files without说明 are not enough.
- Read the author说明 fully, including requirements, file descriptions, compatibility notes, changelog warnings, uninstall notes, and installer option text.
- If the说明 is in another language, translate it. Skipping because it is long or English is not acceptable.
- If no author说明 exists, stop by default. Ask for the original page/source or decline to form an install plan.
- Query KB for game-specific operational facts before applying a variant, runtime, archive, script, or plugin assumption.
- Build a file matrix: main file(s), optional file(s), patches, translations, asset packs, old files, update-only files, and mutually exclusive variants.
- Choose variants from author meaning plus current pack state, not from filename vibes, popularity, or whatever the installer preselected.
- Sequence prerequisites before dependents: required masters/frameworks/assets/tools first, then the mod, then optional patches/translations as instructed.
- For FOMOD/manual choices, record what was selected and why in terms the future maintainer can audit.
- Rename and classify installed components so ownership is obvious: main file, compatibility patch, translation, or tool/output component.
- Preserve a path back to the author page/source so future debugging can re-read the instructions.
- If an instruction requires an adjacent tool operation, hand off to the exact tool skill for that operation after this interpretation.
- If one ambiguity remains, ask one focused blocker question with a recommended default; do not invent an install path.
Red Flags (STOP)
| Thought | Reality | |---|---| | "No description probably means normal install." | No说明 means risk cannot be assessed. Stop or find the original source. | | "The file mirror has the archive, so the page doesn't matter." | The page is the install surface; files alone lose requirements and consequences. | | "The FOMOD default is probably right." | Defaults are not pack-aware. Read option text and author notes. | | "I can choose the variant from the filename." | Variant names are clues, not instructions. Confirm game/runtime/pack requirements. | | "The instructions are English; I'll skim." | Translate and read. Language friction is not a waiver. | | "The mod manager will sort it out." | Managers execute operations; they do not understand author intent. | | "Patch is a good enough local name." | A patch with no owner is future debugging debt. | | "Disable is rollback." | Some mods, especially scripted ones, do not cleanly leave an active save. | | "This is install work, so KB is unnecessary." | Game/runtime facts live in KB; the skill is deliberately game-agnostic. |
Rationalizations
| Excuse | Reality | |---|---| | "I already decided the mod is good, so install is routine." | Inclusion answers worth; install still has file, option, prerequisite, and consequence decisions. | | "I'll download every optional file and sort it later." | Optional files often encode mutually exclusive variants or patch stacks. Build the matrix first. | | "I'll install first and read if something breaks." | Reading is the install step that prevents preventable breakage. | | "I remember what this patch is for." | Future-you forgets. Name and classify now. | | "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. | | "The comments say another variant works better." | Comments are clues; author instructions and current-game KB facts carry the plan. | | "This is just a translation/asset/optional file." | Optional components still change ownership, conflict surfaces, and uninstall behavior. | | "A generic install checklist is faster." | BB84's point is not checklist compliance; it is active reading and consequence awareness. |
Recommended Approach: Senior Curator's Lens
This section reflects an experienced curator's perspective, distilled from BB84's BGS modpack curation work. It is RECOMMENDED guidance, not enforced rule. If the user has explicit alternative intent (different install policy, different risk tolerance, or pack-specific convention), the agent SHOULD adapt rather than push these defaults. The objective rules in this skill body still apply.
Recommended author-instruction lens:
- Honest detailed instructions = green flag. Author who lists prerequisites, conflicts, version compatibility, FOMOD option meanings, and known issues earns trust. Curt or evasive instructions earn skepticism.
- Patreon-locked main version or essential patches = red flag. Walls critical content behind paywall while expecting community patches; structurally breaks the community patch ecosystem.
See KB record `mod-evaluation.author-si
Truncated for display — read the full file on GitHub.
Related Skills
siyuan
47.3kAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
