Waza README

The project's README from github.com/tw93/Waza. As one markdown file: README.md.

Waza

Engineering habits you already know, turned into skills AI agents can run.

LLM guide

Tests Stars Version License Twitter

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.
/ui 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 against project constraints, verifies the result, and handles approved release and maintainer actions.
/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 Returns a concise summary, or clean Markdown for conversion, quotes, citations, saving, or further research.
/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

Claude Code, Codex, Cursor, and other agents

npx skills add tw93/Waza -a claude-code codex cursor -g -y

One copy lands in ~/.agents/skills, the shared skills directory. Claude Code is symlinked in; Codex, Cursor, Gemini CLI, Copilot, Amp, Kimi Code CLI, and every other agent that reads that directory picks the eight skills up as /check, /think, and so on. Agents with a private skills directory take their id after -a (for example antigravity-cli or qwen-code). Update with npx skills update -g -y.

Host plugin, if you prefer the host's own update command (skills are namespaced, /waza:check)

# Claude Code (update: claude plugin update waza)
/plugin marketplace add tw93/Waza
/plugin install waza@waza

# Codex (update: codex plugin marketplace upgrade waza, then codex plugin add waza@waza)
codex plugin marketplace add tw93/Waza
codex plugin add waza@waza

Claude Desktop: download waza.zip, open Customize > Skills > "+" > Create skill, and upload the ZIP. To update, click "..." on the skill card, choose Replace, and upload the latest ZIP.

Pi: pi install npm:@tw93/waza, update with pi update npm:@tw93/waza.

Chaining Skills

You decide how skills chain together. Each skill stops at the requested outcome; an explicitly authorized workflow continues without asking you to approve every transition.

Common workflows:

Project Context

Waza ships only generic engineering habits. /check becomes project-aware at runtime by reading the target repository's public context (READMEs, package manifests, Makefiles, CI workflows) and your task constraints, never private paths, credentials, or tokens. See skills/check/references/project-context.md for the review context template.

Extras

Statusline

A minimal statusline for Claude Code: context window, 5-hour quota, and 7-day quota. Color-coded by usage, no progress bars, no noise.

(
  set -e
  WAZA_STATUSLINE_SCRIPT="$(mktemp -t waza-statusline.XXXXXX)"
  trap 'rm -f "$WAZA_STATUSLINE_SCRIPT"' EXIT
  curl -fL https://github.com/tw93/Waza/releases/latest/download/setup-statusline.sh -o "$WAZA_STATUSLINE_SCRIPT"
  # review it first: less "$WAZA_STATUSLINE_SCRIPT"
  bash "$WAZA_STATUSLINE_SCRIPT"
)

Codex has native statusline items. Add to ~/.codex/config.toml:

[tui]
status_line = ["model-with-reasoning", "current-dir", "context-used", "five-hour-limit", "weekly-limit"]
status_line_use_colors = true

Codex shows remaining quota; the Claude Code statusline above shows used percentage (upstream does not yet expose five-hour-used / weekly-used).

Optional Rules

Three independent toggles. Copy the ones you want (swap claude-code for codex or antigravity-cli on those agents):

(
  set -e
  WAZA_RULE_SCRIPT="$(mktemp -t waza-rule.XXXXXX)"
  trap 'rm -f "$WAZA_RULE_SCRIPT"' EXIT
  curl -fL https://github.com/tw93/Waza/releases/latest/download/setup-rule.sh -o "$WAZA_RULE_SCRIPT"
  # review it first: less "$WAZA_RULE_SCRIPT"

  # English coaching: appends a short 😇 correction when your prompt has an English mistake
  bash "$WAZA_RULE_SCRIPT" english claude-code

  # Anti-patterns: always-on cross-skill guardrails (read before acting, no scope creep, no unsolicited summaries)
  bash "$WAZA_RULE_SCRIPT" anti-patterns claude-code

  # Routing hint: tells non-Claude hosts to prefer Waza skills when a request matches their triggers
  bash "$WAZA_RULE_SCRIPT" waza-routing claude-code
)

Curl URLs use the latest GitHub release asset. Set WAZA_REF=main before the command if you want bleeding-edge scripts.

Why

Waza (技, わざ) is a Japanese martial arts term for technique: a move practiced until it becomes instinct.

A good engineer does more than write code. They pressure-test requirements, debug to root cause, review their own diffs, and read primary sources. AI has the raw output for all of it, but without structure that output drifts into generic, imprecise work. Each Waza skill states the outcome, the red lines, and how the result gets verified, then steps back and lets the model choose the path. As models improve, that restraint pays compound interest.

Tools like Superpowers and gstack are powerful but heavy: too many skills, too much configuration. Waza stays small, eight skills for the habits that actually matter, each with one job and a clear trigger. Built from real projects and refined through 300+ sessions across 7 projects, every gotcha traces to a real failure. The /health skill grew from the six-layer Claude Code framework in this post.

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.

Uninstall

npx skills remove tw93/Waza -g
rm -f ~/.claude/statusline.sh
rm -f ~/.claude/rules/english.md
rm -f ~/.claude/rules/anti-patterns.md
rm -f ~/.claude/rules/waza-routing.md

For Claude Desktop, delete Waza from Customize > Skills. For Codex rule installs, remove the marked Waza blocks from ~/.codex/AGENTS.md.

Support

These lovely people already did 🐱

License

MIT License. Feel free to use Waza and contribute.

Waza (tw93/Waza)

Searching Database…

7.3K ·GitHub
Waza
Что это такое?Waza — это набор из восьми «навыков», которые превращают проверенные инженерные привычки (планирование, дизайн интерфейсов, проверку кода, отладку, написание текстов, исследования, чтение и проверку состояния агентов) в слеш-команды, которые могут выполнять ИИ-агенты для программирования, например Claude Code.
Это библиотека или что-то другое?Это не код, который подключается через import, а общая папка с навыками. Каждый из восьми навыков — это папка со справочными документами, вспомогательными скриптами и известными подводными камнями, которые ваш ИИ-агент читает и выполняет как слеш-команду.
Как установить навыки?Выполните `npx skills update -g -y`, чтобы разместить общую копию в `~/.agents/skills`; для Claude Desktop скачайте waza.zip и добавьте его через Customize > Skills > Create skill.
Какие ИИ-агенты действительно могут использовать эти навыки?Claude Code подключается автоматически через симлинк; Codex, Cursor, Gemini CLI, Copilot, Amp, Kimi Code CLI, Pi и любой другой агент, который читает общую папку с навыками, подхватывают те же восемь навыков.
Waza знает что-нибудь о моём конкретном проекте?Нет — Waza содержит только общие инженерные привычки. Команда /check во время работы учитывает особенности проекта, читая публичный контекст репозитория (README, манифесты, CI-файлы), но никогда не трогает приватные пути, учётные данные или токены.
Какие восемь навыков входят в набор?/think (проверка плана на прочность перед сборкой), /ui (оригинальный дизайн фронтенда), /check (проверка изменений перед слиянием или релизом), /hunt (отладка с поиском первопричины), /write (редактирование текста в естественном стиле), /learn (шестиэтапный процесс исследования), /read (краткое изложение страниц по URL и PDF), /health (проверка состояния настройки агента).
Можно ли объединять навыки в рабочий процесс?Да. По умолчанию каждый навык останавливается на своём результате, но вы можете разрешить цепочку вроде /think → реализация → /check → слияние или /hunt → исправление → /check, и агент будет продолжать работу без запроса подтверждения на каждом шаге.
Зачем создавать Waza, если есть такие инструменты, как Superpowers?Автор считает Superpowers и gstack мощными, но слишком громоздкими: в них слишком много навыков и слишком много настроек. Waza намеренно остаётся небольшим: восемь навыков, у каждого одна задача и понятный триггер, доработанных по итогам более 300 реальных сессий.
Для чего нужна дополнительная строка статуса?Это минималистичная строка статуса Claude Code, которая показывает заполненность контекстного окна и квоту за 5 часов и 7 дней с цветовой индикацией, без индикаторов прогресса; для Codex предусмотрена встроенная настройка строки статуса через ~/.codex/config.toml.
What are similar projects?superpowers-zh, open-steps, Coding-Agent-Skills, pstack, pstack-claude, superpowers, evondevKit, brag
Which topics is it in?npx, claude-skill, copilot, gemini-cli, claude-code-skill, code-review, debugging, workflow, design, cursor, skills, agents
Creator
tw93
Size
6.1 MB
Stars
7.3K
Updated
CommitOct 18Releasev3.40.0Oct 15
Age
7mo
Commits · 90 Days