hax-skills

Monorepo for several reusable Codex skills, maintained as one Git repository.

The canonical installable skill roots live under skills/ and follow the same layout:

skills/<skill-name>/
  SKILL.md
  agents/
  references/
  scripts/

That makes the repository easier to validate, install, and maintain with generic tooling.

Included Skills

Skill Directory	Installed As	Purpose
skills/desktop-gui-dev/	desktop-gui-dev	Desktop GUI app selection, scaffolding, implementation, packaging, and review
skills/frontend-dev/	frontend-dev	React web frontend development with shadcn/ui (Vite/Next.js), theming, forms, and accessibility
skills/phaser/	phaser	Phaser 3 browser game development, debugging, and runtime validation
skills/game-asset-gen/	game-asset-gen	Pixel-art sprite, icon, and frame-sequence generation for retro 2D games
skills/spine-animation/	spine-animation	Spine 2D rigging and skeletal animation from existing art, with atlas export and HTML preview
skills/combat-sim-tuning/	combat-sim-tuning	Monte Carlo combat simulation for balance validation: seeded batches, win-rate and battle-length distributions, damage share, sensitivity, constrained tuning search, and regression gates
skills/game-remake-research/	game-remake-research	Research-pack workflow for remaking an existing game
skills/permission-system/	permission-system	RBAC authorization design and implementation: role-permission matrix, menu and button permissions, row and column data permissions, SaaS plan ceilings
skills/bdd-skill/	bdd-skill	BDD and Gherkin drafting, refinement, and review
skills/ralph-loop/	ralph-loop	Closed-loop autonomous engineering protocol until done
skills/subagents/	subagents	Lead-agent orchestration for branch-isolated multi-agent collaboration

Repository Layout

hax-skills/
  skills/
    desktop-gui-dev/
    frontend-dev/
    phaser/
    game-asset-gen/
    spine-animation/
    combat-sim-tuning/
    game-remake-research/
    permission-system/
    bdd-skill/
    ralph-loop/
    subagents/
  scripts/
    link-skills.sh
    validate_skill_layout.py
  .github/
    workflows/
      validate-skills.yml
      game-remake-research-ci.yml

Notes:

• Every directory under skills/ is an installable Skill root.
• The folder name of each installed Skill matches the name: field in its SKILL.md.
• Repo-level helpers such as CI, packaging, and tests live outside skills/ so the Skill payloads stay clean.

Install Into Codex

Use the helper script to symlink every Skill in skills/ into $CODEX_HOME/skills.

./scripts/link-skills.sh

By default, the script links into ~/.codex/skills. Override CODEX_HOME if needed:

CODEX_HOME=/path/to/.codex ./scripts/link-skills.sh

Maintenance

• Edit the installable payloads directly under skills/.
• Keep tests and packaging helpers outside the Skill roots.
• Run python3 ./scripts/validate_skill_layout.py --strict-warnings before pushing structural Skill changes.
• The Game Remake Research smoke workflow lives at .github/workflows/game-remake-research-ci.yml.
• The repo-wide layout validator lives at .github/workflows/validate-skills.yml.

Push To GitHub

Once the remote is configured, push the monorepo normally:

git push -u origin main