Agent skill

Hai TDD

Drives a real behavior change through red-green-refactor and records the failing RED evidence, minimal GREEN implementation, refactor decision, and verification commands.

Custom licenceAuto-check passedTesting & QA

Install Hai TDD

skills CLI

$ npx skills add hylarucoder/hai-stack --skill hai-tdd -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install hylarucoder/hai-stack hai-tdd --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/hylarucoder/hai-stack.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/hai-tdd .claude/skills/hai-tdd && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "hai-tdd" agent skill from https://github.com/hylarucoder/hai-stack/tree/main/skills/hai-tdd into .claude/skills/hai-tdd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hai-tdd", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/hylarucoder/hai-stack/tree/main/skills/hai-tdd

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add hylarucoder/hai-stack --skill hai-tdd -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install hylarucoder/hai-stack hai-tdd --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/hylarucoder/hai-stack.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/hai-tdd .agents/skills/hai-tdd && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "hai-tdd" agent skill from https://github.com/hylarucoder/hai-stack/tree/main/skills/hai-tdd into .agents/skills/hai-tdd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hai-tdd", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add hylarucoder/hai-stack --skill hai-tdd -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install hylarucoder/hai-stack hai-tdd --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/hylarucoder/hai-stack.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/hai-tdd .cursor/skills/hai-tdd && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "hai-tdd" agent skill from https://github.com/hylarucoder/hai-stack/tree/main/skills/hai-tdd into .cursor/skills/hai-tdd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hai-tdd", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/hylarucoder/hai-stack.git --path skills/hai-tdd

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add hylarucoder/hai-stack --skill hai-tdd -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install hylarucoder/hai-stack hai-tdd --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/hylarucoder/hai-stack.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/hai-tdd .gemini/skills/hai-tdd && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "hai-tdd" agent skill from https://github.com/hylarucoder/hai-stack/tree/main/skills/hai-tdd into .gemini/skills/hai-tdd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hai-tdd", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install hylarucoder/hai-stack hai-tdd

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add hylarucoder/hai-stack --skill hai-tdd -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/hylarucoder/hai-stack.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/hai-tdd .github/skills/hai-tdd && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "hai-tdd" agent skill from https://github.com/hylarucoder/hai-stack/tree/main/skills/hai-tdd into .github/skills/hai-tdd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hai-tdd", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add hylarucoder/hai-stack --skill hai-tdd -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install hylarucoder/hai-stack hai-tdd --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/hylarucoder/hai-stack.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/hai-tdd .opencode/skills/hai-tdd && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "hai-tdd" agent skill from https://github.com/hylarucoder/hai-stack/tree/main/skills/hai-tdd into .opencode/skills/hai-tdd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hai-tdd", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: hai-tdd
GitHub stars: 382
Token cost: ~1.8k tokens
SKILL.md length: 986 words
Files: 4 (incl. references)
Skills in repo: 18
Repo updated: Oct 5, 2026
First seen: Oct 7, 2026
Licence: Custom licence

At a glance

Drives a real behavior change through red-green-refactor and records the failing RED evidence, minimal GREEN implementation, refactor decision, and verification commands.

Works in 7 steps: Define the target behavior. → RED: write the failing test first. → Verify RED. → …
The user explicitly asks for TDD/tests first
SKILL.md covers Overview, Core Principle, When TDD does not fit and No Fake RED, plus 5 more sections
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Hai TDD is an agent skill from hylarucoder/hai-stack. Drives a real behavior change through red-green-refactor and records the failing RED evidence, minimal GREEN implementation, refactor decision, and verification commands. Use when the user explicitly asks for TDD/tests first, adds or fixes testable behavior, or needs regression protection（先写测试、红绿重构、补回归测试）. Do not force TDD onto documentation, configuration, styling, renames, package moves, or other purely structural changes; report honest non-TDD verification instead.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `SKILL.zh_CN.md`, `agents/openai.yaml` and `references/output-template.md`).

It sits in Testing & QA, covering Test-driven development.

When your agent uses it

The user explicitly asks for TDD/tests first
Fixes testable behavior
Needs regression protection（先写测试、红绿重构、补回归测试）

Example prompts

“Use the hai-tdd skill to drive a real behavior change through red-green-refactor and records the failing RED evidence, minimal GREEN implementation…”
“/hai-tdd”

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

Define the target behavior.
RED: write the failing test first.
Verify RED.
GREEN: write the minimal implementation.
Verify GREEN.
REFACTOR.
Continue with the next behavior.

What it can do on your machine

Read from SKILL.md and the folder at commit a6c7ed2. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Hai TDD loads about 1.8k tokens when it runs, and up to ~2.3k if it reads all its reference files. Until then it costs about 120 tokens; SKILL.md has 986 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~120
When it runs · the whole SKILL.md, loaded when a task matches: ~1.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~2.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 986 words (~1,752 tokens).

“For Chinese readers, see SKILL.zh_CN.md. The English SKILL.md is the execution source of truth.”

— opening of SKILL.md by hylarucoder, Custom licence

name: hai-tdd

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files (references) in skills/hai-tdd of hylarucoder/hai-stack.

SKILL.md
SKILL.zh_CN.md
agents/openai.yaml
references/output-template.md

Open the folder on GitHubat commit a6c7ed2

Compare with similar skills

Hai TDD next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Hai TDD compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Hai TDD this skillhylarucoder/hai-stack	382	—	~1.8k	Automated safety check: Pass	Custom licence	3 days ago
TDDpietheinstrengholt/rssmonster	564	30 repos	~906	Automated safety check: Pass	MIT	yesterday
TDD WorkflowhellangleZ/burn-in-cceverywhere-ralph	112	11 repos	~2.4k	Automated safety check: Pass	None	8 mo ago
TDDsanity-io/sanity	6.4k	20 repos	~1k	Automated safety check: Pass	MIT	today
Test Driven Developmentfarm-fe/farm	5.6k	51 repos	~2.5k	Automated safety check: Pass	MIT	16 days ago
Tapd Story PipelineTencentBlueKing/bk-bcs	840	—	~2.6k	Automated safety check: Pass	Custom licence	today

Similar skills

TDD
pietheinstrengholt/rssmonster
Test-driven development. An agent skill from pietheinstrengholt/rssmonster.
564 GitHub starsUsed in 30 repos~906 tokens
Testing & QAAuto-check passed
TDD Workflow
hellangleZ/burn-in-cceverywhere-ralph
A skill your agent uses when writing new features, fixing bugs, or refactoring code.
112 GitHub starsUsed in 11 repos~2.4k tokens
Testing & QAAuto-check passed
TDD
sanity-io/sanity
Official
Test-driven development with red-green-refactor loop. An agent skill from sanity-io/sanity.
6.4k GitHub starsUsed in 20 repos~1k tokens
Testing & QAAuto-check passed
Test Driven Development
farm-fe/farm
A skill your agent uses when implementing any feature or bugfix, before writing implementation code
5.6k GitHub starsUsed in 51 repos~2.5k tokens
Testing & QAAuto-check passed
Tapd Story Pipeline
TencentBlueKing/bk-bcs
单需求实现流水线——把一个 TAPD 需求从零推进到代码提交。自动串联技术澄清、开发计划、任务拆分、TDD 实现、架构/安全校验、代码提交六个阶段。
840 GitHub stars~2.6k tokensUpdated today
Testing & QAAuto-check passed
Absolute Init
maddhruv/absolute
One-time setup for absolute: interview how you want it to behave (output style, autonomy, TDD strictness, spec dir, families) + detect the stack once, then write .absolute.config.json (project…
218 GitHub starsUsed in 1 repo~3k tokens
Testing & QAAuto-check passed

More from hylarucoder/hai-stack

All 18 skills in this repo

Write Technical Acceptance Report
hylarucoder/hai-stack
Verify a defined software change against requirements and produce a proportional, evidence-backed acceptance report with specification precedence, scope boundaries, requirement-to-evidence…
382 GitHub stars~2.1k tokensUpdated 3 days ago
Auto-check passed
Hai Ast Grep
hylarucoder/hai-stack
Produces a ready-to-run ast-grep command or reusable YAML lint/codemod rule, validated against positive and negative fixtures.
382 GitHub stars~1.5k tokensUpdated 3 days ago
Auto-check passed
Readme Beautifier
hylarucoder/hai-stack
Reformats and restructures a README or similar Markdown project document without changing its factual content, voice, or scope, then summarizes formatting-only edits.
382 GitHub stars~1.8k tokensUpdated 3 days ago
Auto-check passed
Hai Visual Explainer
hylarucoder/hai-stack
Turns supplied content into self-contained HTML and PNG in two modes: card for one shareable frame（知识卡、信息卡、金句卡、封面、把要点做成一张图）, report for multi-section documents（可视化报告、HTML 汇报页、PRD/计划/评审做成网页）.
382 GitHub stars~2k tokensUpdated 3 days ago
Auto-check passed
Code Review And Quality
hylarucoder/hai-stack
Reviews a code change for correctness, security, maintainability, architecture, performance, and verification gaps, or performs a local code-smell review.
382 GitHub stars~934 tokensUpdated 3 days ago
Auto-check passed
Entity Model Auditor
hylarucoder/hai-stack
Audits an entity model field by field: what should exist, what exists now, where each value belongs (column, config, computed runtime value, or removal), and what must migrate.
382 GitHub stars~1.5k tokensUpdated 3 days ago
Auto-check passed

Questions about Hai TDD

What does Hai TDD do?

Drives a real behavior change through red-green-refactor and records the failing RED evidence, minimal GREEN implementation, refactor decision, and verification commands. Hai TDD is an agent skill from hylarucoder/hai-stack. Drives a real behavior change through red-green-refactor and records the failing RED evidence, minimal GREEN implementation, refactor decision, and verification commands.

When should I use Hai TDD?

Hai TDD fits situations like: the user explicitly asks for TDD/tests first; fixes testable behavior; needs regression protection（先写测试、红绿重构、补回归测试）.

How do I install Hai TDD in Claude Code?

Run `npx skills add hylarucoder/hai-stack --skill hai-tdd -a claude-code`. Or copy the skill folder (skills/hai-tdd in hylarucoder/hai-stack) into .claude/skills/hai-tdd in your project. Claude Code loads it when a task matches its description.

How do I install Hai TDD in Codex?

Run `npx skills add hylarucoder/hai-stack --skill hai-tdd -a codex`. Or copy the skill folder (skills/hai-tdd in hylarucoder/hai-stack) into .agents/skills/hai-tdd in your project. Codex loads it when a task matches its description.

Can I use Hai TDD in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hylarucoder/hai-stack --skill hai-tdd -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hai-tdd, .gemini/skills/hai-tdd, .github/skills/hai-tdd and .opencode/skills/hai-tdd in your project.

What does Hai TDD need to run?

SKILL.md names no scripts, command-line tools or credentials: Hai TDD is instructions for the agent only.

Does Hai TDD access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Hai TDD safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Hai TDD use?

Hai TDD has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Hai TDD use?

About 1.8k tokens (SKILL.md is roughly 7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 508 tokens, read only when the agent opens those files.

What are the alternatives to Hai TDD?

Skills that share tags, products or a category with Hai TDD: TDD (pietheinstrengholt/rssmonster, 564 stars), TDD Workflow (hellangleZ/burn-in-cceverywhere-ralph, 112 stars), TDD (sanity-io/sanity, 6.4k stars) and Test Driven Development (farm-fe/farm, 5.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hai TDD?

hylarucoder (a GitHub user) maintains it in hylarucoder/hai-stack, which has 382 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on October 5, 2026.

Source: hylarucoder/hai-stack on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Hai TDD

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Files

Compare with similar skills

Similar skills

More from hylarucoder/hai-stack

Related

Questions about Hai TDD