WingedGuardian/x4-ai-toolkit
AI-assisted X4: Foundations modding with Claude Code and Codex; OpenCode support is best effort. Inspect merged game data, validate XML patches, investigate mod conflicts, review your mod list, and build or repair mods with X4-specific know
field: Games workflow: CI/CD & deployTesting & TDDPR / code reviewGit & commitsResearch runs codex in CI
stack: Python
ARCHETYPE
Skill Collector
Ten-plus skills loaded on demand. A procedural-knowledge library.
GUARDRAILS
3/5
Blocks destructive commands · Pre-tool screening hook · No YOLO mode · details
Quality 38/100 Guardrails v2
Copy this rig
# review before running: this installs third-party code
$ npx degit WingedGuardian/x4-ai-toolkit/.claude ./rig-x4-ai-toolkit # inspect, then merge into .claude/ MCP servers are added to Claude Code at local scope; env vars are shown as YOUR_… placeholders — we never store values. Files are fetched with degit into a separate folder so you can review before merging.
$ npx degit WingedGuardian/x4-ai-toolkit/.agents/skills/find-session .claude/skills/find-session $ npx degit WingedGuardian/x4-ai-toolkit/.agents/skills/x4-balance .claude/skills/x4-balance $ npx degit WingedGuardian/x4-ai-toolkit/.agents/skills/x4-cli-reference .claude/skills/x4-cli-reference $ npx degit WingedGuardian/x4-ai-toolkit/.agents/skills/x4-debug .claude/skills/x4-debug $ npx degit WingedGuardian/x4-ai-toolkit/.agents/skills/x4-live .claude/skills/x4-live $ npx degit WingedGuardian/x4-ai-toolkit/.agents/skills/x4-mod-interaction .claude/skills/x4-mod-interaction $ npx degit WingedGuardian/x4-ai-toolkit/.agents/skills/x4-mod-release-review .claude/skills/x4-mod-release-review $ npx degit WingedGuardian/x4-ai-toolkit/.agents/skills/x4-modlist-review .claude/skills/x4-modlist-review $ npx degit WingedGuardian/x4-ai-toolkit/.agents/skills/x4-probe .claude/skills/x4-probe $ npx degit WingedGuardian/x4-ai-toolkit/.agents/skills/x4-scaffold .claude/skills/x4-scaffold $ npx degit WingedGuardian/x4-ai-toolkit/.agents/skills/x4-toolkit-dev .claude/skills/x4-toolkit-dev $ npx degit WingedGuardian/x4-ai-toolkit/.agents/skills/x4-update-mod .claude/skills/x4-update-mod $ npx degit WingedGuardian/x4-ai-toolkit/.agents/skills/x4-xml-patching .claude/skills/x4-xml-patching
$ curl -fsSL --create-dirs -o .claude/agents/cross-file-impact.md https://raw.githubusercontent.com/WingedGuardian/x4-ai-toolkit/master/.claude/agents/cross-file-impact.md $ curl -fsSL --create-dirs -o .claude/agents/mod-research.md https://raw.githubusercontent.com/WingedGuardian/x4-ai-toolkit/master/.claude/agents/mod-research.md
Merge into .claude/settings.json (project) or ~/.claude/settings.json (user). Hook commands reference scripts in the source repo — copy those too.
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/protect-bash.sh\""
}
]
},
{
"matcher": "PowerShell",
"hooks": [
{
"type": "command",
"command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/protect-bash.sh\""
}
]
},
{
"matcher": "Edit|Write|NotebookEdit",
"hooks": [
{
"type": "command",
"command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/protect-files.sh\""
},
{
"type": "command",
"command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/backup-before-edit.sh\""
}
]
},
{
"matcher": "Grep|Glob",
"hooks": [
{
"type": "command",
"command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/search-scope.sh\""
}
]
}
]
}
} Skills (13)
find-sessionx4-balancex4-cli-referencex4-debugx4-livex4-mod-interactionx4-mod-release-reviewx4-modlist-reviewx4-probex4-scaffoldx4-toolkit-devx4-update-modx4-xml-patching
Subagents (2)
| cross-file-impact model: sonnet | Use BEFORE implementing a multi-file X4 change. Traces ALL files that must change for an intended change (the cross-file dependency fan-out) so nothing is forgotten. The structural complement to x4val |
| mod-research model: sonnet | Use BEFORE editing or updating any X4 mod. Researches a mod's Nexus page (description, articles, changelogs, comments, bug reports) and maps the relevant reference\ structure, returning a distilled br |
Hooks (11)
| event | matcher | runs |
|---|---|---|
| PreToolUse | Bash | bash "$CLAUDE_PROJECT_DIR/.claude/hooks/protect-bash.sh" |
| PreToolUse | PowerShell | bash "$CLAUDE_PROJECT_DIR/.claude/hooks/protect-bash.sh" |
| PreToolUse | Edit|Write|NotebookEdit | bash "$CLAUDE_PROJECT_DIR/.claude/hooks/protect-files.sh" |
| PreToolUse | Edit|Write|NotebookEdit | bash "$CLAUDE_PROJECT_DIR/.claude/hooks/backup-before-edit.sh" |
| PreToolUse | Grep|Glob | bash "$CLAUDE_PROJECT_DIR/.claude/hooks/search-scope.sh" |
| PostToolUse | Edit|Write|NotebookEdit | bash "$CLAUDE_PROJECT_DIR/.claude/hooks/x4validate-on-edit.sh" |
| PostToolUse | Bash|PowerShell|Edit|Write|NotebookEdit|mcp__.* | bash "$CLAUDE_PROJECT_DIR/.claude/hooks/save-sentinel.sh" |
| SessionStart | * | bash "$CLAUDE_PROJECT_DIR/.claude/hooks/check-reference-version.sh" |
| SessionStart | * | bash "$CLAUDE_PROJECT_DIR/.claude/hooks/session-canary.sh" |
| SessionStart | * | bash "$CLAUDE_PROJECT_DIR/.claude/hooks/charter.sh" session-start |
| UserPromptSubmit | * | bash "$CLAUDE_PROJECT_DIR/.claude/hooks/charter.sh" prompt |
Similar rigs
liatrio-labs/claude-code-gauntlet
Adversarial code review for Claude Code: each GitHub PR or GitLab MR runs a gauntlet of up to seven specialist agents for bugs, security, tests and cross-file impact, and every finding must survive verification, a skeptical validator, and a
Orchestrator 1.6k tok · · Q18
kergoth/dotfiles
Primary dotfiles & scripts repository
Skill Collector 2.5k tok · · Q15
ooooooooooooooooooop/personal-ai
Agent skills repository
Skill Collector 4.3k tok · · Q3
wardawgmalvicious/claude-plugins
Claude Code plugin marketplace (private until its first release)
Skill Collector 2.8k tok · · Q0