{"id":51604101,"url":"https://github.com/postigodev/hoi4-agent-skill","last_synced_at":"2026-07-12T00:02:15.242Z","repository":{"id":365382121,"uuid":"1244801071","full_name":"postigodev/hoi4-agent-skill","owner":"postigodev","description":"a portable Agent Skill for creating, editing, and debugging Hearts of Iron IV mods with AI coding agents","archived":false,"fork":false,"pushed_at":"2026-06-17T04:28:42.000Z","size":45,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-17T06:19:25.546Z","etag":null,"topics":["agent-skills","ai-assisted-modding","claude","cline","codex","cursor","hearts-of-iron-iv","hoi4","modding","paradox","paradox-script","skills"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/postigodev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-20T15:57:58.000Z","updated_at":"2026-06-17T04:24:46.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/postigodev/hoi4-agent-skill","commit_stats":null,"previous_names":["postigodev/hoi4-agent-skill"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/postigodev/hoi4-agent-skill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/postigodev%2Fhoi4-agent-skill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/postigodev%2Fhoi4-agent-skill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/postigodev%2Fhoi4-agent-skill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/postigodev%2Fhoi4-agent-skill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/postigodev","download_url":"https://codeload.github.com/postigodev/hoi4-agent-skill/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/postigodev%2Fhoi4-agent-skill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35377925,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-11T02:00:05.354Z","response_time":104,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","ai-assisted-modding","claude","cline","codex","cursor","hearts-of-iron-iv","hoi4","modding","paradox","paradox-script","skills"],"created_at":"2026-07-12T00:02:07.051Z","updated_at":"2026-07-12T00:02:15.227Z","avatar_url":"https://github.com/postigodev.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# HOI4 Agent Skill\n\nA portable agent skill for creating, editing, reviewing, and debugging Hearts of Iron IV mods with AI coding agents.\n\n**AI-assisted HOI4 modding without AI slop.**\n\nHOI4 Agent Skill turns AI coding agents from generic code writers into cautious Paradox-script modding assistants.\n\nIt helps agents work with:\n\n- mod descriptors and folder structure\n- national focus trees\n- events and namespaces\n- decisions\n- ideas and national spirits\n- countries, states, and history files\n- localization\n- GFX and interface references\n- scripted effects and triggers\n- `error.log` debugging\n\n## Supported Agents\n\nThe canonical skill lives in:\n\n```txt\nskills/hoi4-modding/\n```\n\nThe repository is designed to be portable across:\n\n- Codex Skills\n- Claude Skills\n- Cursor Rules\n- Cline Rules\n- `AGENTS.md`-compatible agents\n\nPlatform adapters live under:\n\n```txt\nadapters/\n```\n\nAdapters are intentionally thin. The canonical behavior belongs in `skills/hoi4-modding/SKILL.md`.\n\n## Why This Exists\n\nHOI4 modding failures often come from brittle project structure rather than ordinary programming mistakes:\n\n- wrong descriptor path\n- wrong event namespace\n- wrong trigger or effect scope\n- wrong localization key\n- wrong sprite reference\n- wrong folder or file name\n- missing braces or malformed Paradox script\n- guessing from symptoms instead of reading `error.log`\n\nThis skill encodes those failure modes into reusable agent behavior.\n\nIt is not a replacement for learning HOI4 modding. It is a guardrail for agents: inspect structure, preserve IDs, add localization, respect namespaces and scopes, check GFX references, and debug through `error.log` instead of guessing.\n\n## Install\n\nUse the `skills/hoi4-modding/` directory with your agent platform.\n\n### Install With Codex\n\n```txt\n$skill-installer install https://github.com/postigodev/hoi4-agent-skill/tree/main/skills/hoi4-modding\n```\n\nRestart Codex after installing.\n\n### Use With Claude\n\nUpload or install the `skills/hoi4-modding/` folder as a Claude Skill.\n\n### Use With Cursor\n\nCopy:\n\n```txt\nadapters/cursor/.cursor/rules/hoi4-modding.mdc\n```\n\ninto your mod repository at:\n\n```txt\n.cursor/rules/hoi4-modding.mdc\n```\n\nOptionally copy `adapters/cursor/AGENTS.md` to the root of your mod repository.\n\n### Use With Cline\n\nCopy:\n\n```txt\nadapters/cline/.clinerules/hoi4-modding.md\n```\n\ninto your mod repository at:\n\n```txt\n.clinerules/hoi4-modding.md\n```\n\nOptionally copy `adapters/cline/AGENTS.md` to the root of your mod repository.\n\n## What To Try First\n\nOpen a real HOI4 mod repository with the skill installed, then start with:\n\n```txt\nInspect this HOI4 mod before editing. Identify the descriptor, folder structure, country tags, event namespaces, localization conventions, and any obvious load risks. Do not change files yet. Summarize what you found and what you would check in error.log.\n```\n\nAfter the agent reports the structure, ask for a small scoped change, such as:\n\n```txt\nAdd one small ABC focus that grants political power. Follow existing focus ID and localization conventions, keep the edit minimal, and report what I should test in HOI4.\n```\n\n## Examples\n\nOriginal minimal snippets live in:\n\n```txt\nskills/hoi4-modding/examples/\n```\n\nThey cover a tiny focus tree, event, decision, idea, localization file, and GFX declaration using the placeholder tag `ABC`.\n\nDebugging mini-labs live in:\n\n```txt\nskills/hoi4-modding/examples/broken-cases/\n```\n\nUse them to teach agents the difference between namespace mismatches, missing localization, and parse errors that make focus trees disappear.\n\n## Coverage\n\n| Area | Status |\n|---|---|\n| Folder structure and descriptors | Covered |\n| Paradox script basics | Covered |\n| Focus trees | Covered |\n| Events | Covered |\n| Decisions | Covered |\n| Ideas and national spirits | Covered |\n| Countries, history, and states | Covered |\n| Localization | Covered |\n| GFX, interface, and icons | Covered |\n| Scripted effects and triggers | Covered |\n| `error.log` debugging | Covered |\n\n## Asset And Legal Posture\n\nThis repository does not include copied vanilla HOI4 files, DLC files, Paradox artwork, icons, music, localization, or other proprietary game assets.\n\nWhen using the skill, agents should avoid copying proprietary game files or assets into public repositories. Prefer original content, placeholders, or references to assets that already exist in the user's local mod workspace.\n\n## Project Status\n\nCurrent target: `0.2.0`\n\nThe current version is instruction-only. It includes the canonical skill, concise references, examples, thin adapters, and smoke prompts. It intentionally does not include scripts, binaries, dependency installs, or copied game content.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpostigodev%2Fhoi4-agent-skill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpostigodev%2Fhoi4-agent-skill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpostigodev%2Fhoi4-agent-skill/lists"}