# Adding An Attack

> Use when adding a new attack mode to hate_crack — the exact six wiring steps across main.py, attacks.py, and hate_crack.py, including the duplicate menu mapping that is easy to miss.

- Skill: `trustedsec/adding-an-attack` (Agent Skill)
- Install (CLI): `npx skillmds@latest add trustedsec/adding-an-attack`
- Raw SKILL.md: https://api.skillmd.com/api/skills/trustedsec/adding-an-attack/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: trustedsec (https://skillmd.com/u/trustedsec)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/trustedsec/adding-an-attack

---


# Adding a New Attack

An attack spans three files (see "Three-Layer Attack Pattern" in `CLAUDE.md`).
Do all six steps — skipping step 6 leaves the attack invisible from the root
entry point even though it works via `main.py`.

1. Add the hashcat wrapper function in `main.py` (e.g. `hcatMyAttack(...)`)
2. Add the handler in `attacks.py` (e.g. `def my_attack(ctx: Any)`)
3. Add a dispatcher in `main.py`: `def my_attack(): return _attacks.my_attack(_attack_ctx())`
4. Add the print line in `main.py`'s menu display loop (~line 3807+)
5. Add the menu entry in `main.py`'s `get_main_menu_options()`
6. Add the menu entry in `hate_crack.py`'s `get_main_menu_options()` (the duplicate)