Why
Waza (技, わざ) is a Japanese martial arts term for technique: a move practiced until it becomes instinct.
A good engineer does not just write code. They think through requirements, review their own work, debug systematically, design interfaces that feel intentional, and read primary sources. They write clearly, and learn new domains by producing output, not consuming content.
AI is more capable than most engineers at raw output. But without structure, that capability drifts into generic, imprecise work. Waza channels it into precision: eight skills that set clear goals and constraints, then let the model do what it does best.
Part of a trilogy: Kaku (書く) writes code, Waza (技) drills habits, Kami (紙) ships documents. Think of them as a family: Kaku is the dad, Waza the big sister, Kami the little sister.
Skills
Each engineering habit gets an installed skill. In Claude Code, type the slash command. In Codex, invoke the installed skill by name and follow the same playbook.
| Skill | When | What it does |
|---|
/think | Before building anything new | Challenges the problem, pressure-tests the design, and produces a decision-complete plan another agent can implement. |
/design | Building frontend interfaces | Produces distinctive UI, including screenshot-driven aesthetic iteration, with a committed direction rather than generic defaults. |
/check | After a task, before merging or release | Reviews the diff, extracts project-specific constraints, handles approved release/publish/push/reaction follow-through, and verifies with evidence. |
/hunt | Any bug, regression, or unexpected behavior | Systematic debugging. Root cause confirmed before any fix is applied, especially when something used to work. |
/write | Writing or editing prose | Rewrites prose to sound natural in Chinese and English. Cuts stiff, formulaic phrasing. |
/learn | Diving into an unfamiliar domain | Six-phase research workflow: collect, digest, outline, fill in, refine, then self-review and publish. |
/read | Any URL or PDF | Fetches content as clean Markdown with platform-specific routing. Special handling for GitHub, PDFs, WeChat, and Feishu. Privacy-first: defaults to a local extractor; --use-proxy opts into defuddle.md / r.jina.ai for JS-heavy pages. |
/health | Auditing Agent Health | Checks Codex, Claude Code, project instructions, verifier output, and AI maintainability with a budget-aware summary pass before deep inspection. |
Each skill is a folder with reference docs, helper scripts, and gotchas from real failures.
Install and Update
Most users should install Waza globally, so the same skills are available in every project.
Claude Code
npx skills add tw93/Waza -a claude-code -g -y
This installs /think, /design, /check, /hunt, /write, /learn, /read, and /health. Install just one with npx skills add tw93/Waza --skill think -a claude-code -g -y.
Codex
npx skills add tw93/Waza -a codex -g -y
Install just one with npx skills add tw93/Waza --skill think -a codex -g -y. Codex sessions can invoke installed skills by name or link to the installed SKILL.md path shown by npx skills path tw93/Waza.
Claude Code plugin marketplace (single-skill entries require Claude Code v2.1.143+)
/plugin marketplace add tw93/Waza
/plugin install waza@waza
This installs all eight skills. Install just one with /plugin install waza-<name>@waza (for example, waza-think@waza) on Claude Code v2.1.143 or newer.
Claude Desktop
