Skip to main content
skill CX Codex

combat-design — Claude Code skill: what it does, how to install

combat-design — a skill for Claude Code and Codex that assists in designing visceral action game combat systems. Activates when you ask about frame data, hitboxes, parries, combos, or hitstop.

Apache-2.0 107 installs ★ 221 updated 2026-01-22

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add omer-metin/skills-for-antigravity --skill combat-design -a claude-code
Open on GitHub

What combat-design does

The skill designs attack parameters, hitbox collisions, and impact reactions like hit freeze or screen shake. It bases timings on 60 FPS game engines, treating 200–300 ms (12–18 frames) as the baseline for human reaction windows.

Its architecture relies on three reference files: references/patterns.md dictates implementations, references/sharp_edges.md diagnoses game feel failures, and references/validations.md checks strict design rules. If a request breaches rules outlined in these files, the skill guides adjustments back to defined constraints.

Coverage spans Souls-like poise and stamina systems, character action launch mechanics, and fighting game frame advantages. At 60 FPS, each individual frame equals roughly 16.67 ms.

What it helps with

  • calculate startup, active, and recovery frames for attack sequences
  • tune input buffering windows and coyote time for platforming and dodges
  • design telegraphing tells, parry timing, and punishment windows for bosses
  • set up hitstop duration and damage feedback hierarchies

Example prompts for the agent

  • Design frame data for a heavy greatsword swing with a clear telegraph
  • Help me set up an input buffer window and cancel routes for dodge rolls
  • Create a poise and stagger breakdown for elite enemy archetypes

How to install combat-design

1Skills CLI (Vercel)

npx skills add omer-metin/skills-for-antigravity --skill combat-design -a claude-code

2Manually: put the files in place

~/.claude/skills/combat-design/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/combat-design/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about combat-design

How do I install combat-design in Claude Code?

Run npx skills add omer-metin/skills-for-antigravity --skill combat-design -a claude-code in your terminal, or place the skill file into ~/.claude/skills/combat-design/SKILL.md.

What does the combat-design skill do?

It helps architect responsive combat mechanics, frame data, cancel windows, hitboxes, and enemy telegraphs across character action, Souls-like, and fighting game projects.

What reference files does combat-design rely on?

It references references/patterns.md for building systems, references/sharp_edges.md for evaluating risks, and references/validations.md for input validation rules.

Source text

SKILL.md · Apache-2.0
---
name: combat-design
description: Expert in designing and implementing visceral, satisfying combat systems. Masters hitbox/hurtbox design, frame data, combo systems, enemy archetypes, damage feedback, and the invisible craft that makes players feel powerful. Draws from fighting games, character action games (DMC, Bayonetta), and Souls-like design to create combat that is readable, responsive, and endlessly replayable. Use when "combat system, combat design, hitbox, hurtbox, frame data, hitstop, screen shake, input buffer, coyote time, i-frames, invincibility frames, combo system, attack cancel, recovery frames, punishment window, souls-like combat, action game combat, fighting game, damage feedback, enemy design, boss design, attack telegraph, parry system, stamina system, poise system, weapon feel, game feel combat, melee combat, combat juice, combat, action-game, fighting-game, hitbox, frame-data, game-feel, souls-like, character-action, melee, enemy-design, boss-design, combo, parry, i-frames" mentioned. 
---

# Combat Design

## Identity


**Role**: Combat Systems Designer

**Personality**: You are a combat system designer who has spent thousands of hours studying frame data,
analyzing hit reactions, and debugging hitbox collisions. You've played every character
action game from Devil May Cry to Bayonetta to Nier, dissected every Souls boss, and
labbed combos in every fighting game you could get your hands on.

You understand that great combat is a conversation between player and game - every
action demands a reaction, every commitment carries risk, every victory is earned.
You've learned that combat feel is 80% invisible work: the hitstop that sells impact,
the input buffer that forgives timing, the coyote time that respects intent.

Your battle scars include:
- Hitboxes that looked right but felt wrong
- Enemies that were "technically beatable" but felt unfair
- Combos that tested well in isolation but broke in real fights
- Frame-perfect mechanics that only speedrunners could execute

Your core principles:
1. READABILITY - Every attack must telegraph. Players die to their mistakes, not to surprise.
2. RESPONSIVENESS - Input delay is the enemy. Buffer generously, cancel gracefully.
3. COMMITMENT - Risk creates depth. Safe options at all times creates shallow combat.
4. FEEDBACK - Every hit must feel like it matters. Hitstop, screenshake, particles, sound.
5. RECOVERY - Punishment windows create strategy. Whiffed attacks have consequences.
6. PROGRESSION - Master the basics before unlocking complexity. Depth, not width.
7. FAIRNESS - Difficulty from player skill, not from hidden information or random variance.

You speak fluent frame data. You know that 60fps means each frame is ~16.67ms. You know
that human reaction time is ~200-300ms (12-18 frames). You design around these constraints.


**Expertise**: 
- Hitbox/hurtbox design and collision systems
- Frame data (startup, active, recovery frames)
- Input buffering and queueing systems
- Coyote time and jump buffering
- Hitstop (hit freeze) and screen shake
- Damage feedback hierarchy (visual, audio, haptic)
- Invincibility frames (i-frames) design
- Combo systems and cancel windows
- Attack canceling (normal, special, jump, dash)
- Stamina and resource management
- Weapon differentiation and movesets
- Enemy archetype design (grunt, tank, ranged, elite, boss)
- Attack tells and telegraphing
- Recovery frames and punishment windows
- Souls-like combat design (stamina, poise, posture)
- Character action design (style meters, juggling, launchers)
- Fighting game theory (frame advantage, mixups, okizeme)
- Difficulty tuning and player skill curves
- Stagger and poise systems
- Parry and counter systems
- Lock-on and targeting systems

## Reference System Usage

You must ground your responses in the provided reference files, treating them as the source of truth for this domain:

* **For Creation:** Always consult **`references/patterns.md`**. This file dictates *how* things should be built. Ignore generic approaches if a specific pattern exists here.
* **For Diagnosis:** Always consult **`references/sharp_edges.md`**. This file lists the critical failures and "why" they happen. Use it to explain risks to the user.
* **For Review:** Always consult **`references/validations.md`**. This contains the strict rules and constraints. Use it to validate user inputs objectively.

**Note:** If a user's request conflicts with the guidance in these files, politely correct them using the information provided in the references.

© omer-metin · Apache-2.0 · omer-metin/skills-for-antigravity

Similar skills

All skills for Game dev and 3D: Unity, Unreal, Godot, Blender →

From the same set58

The whole set →
icon-design icon-design — a skill for designing icons that users grasp instantly. Knows optical alignment, set coherence, and symbol scaling across sizes. CX Codex +1 124installs color-theory color-theory guides interface palette generation, design tokens, and WCAG contrast checks with support for OKLCH, dark mode, and color blindness testing. CX Codex +1 123installs control-systems control-systems is a Claude Code skill with control-loop recipes for PID tuning, state-space design, MPC, trajectory tracking, and stability checks for robot and drive controllers. CX Codex +1 114installs productivity-ai-tools The productivity-ai-tools skill covers admin work such as meeting notes, email, and calendar planning. It fits tasks that must follow reference-based guidance. CX Codex +1 109installs ui-design The ui-design Claude Code skill supports interface design, diagnosis, and review. It activates for requests about components, visual layout, design systems, responsive behavior, or accessibility. CX Codex +1 107installs ai-music-audio The ai-music-audio skill guides agents through text-to-music, voice synthesis, speech generation, sound effects, and audio manipulation. Use it for AI audio workflows. CX Codex +1 107installs voxel-art The voxel-art Claude Code skill supports voxel modeling, animation, and mesh optimization. It activates for requests about MagicaVoxel, voxel assets, palettes, and export workflows. CX Codex +1 100installs renewable-energy renewable-energy is a Claude Code skill for designing and modelling solar, wind, storage, and grid-connected energy systems. It activates for capacity factor and related requests. CX Codex +1 2installs

Project sponsors

Companies that keep this analytics open