Agent skill

Long Task TDD

by suriyel in suriyel/longtaskforagent

A skill your agent uses when implementing a feature through TDD in a long-task project - enforces Red-Green-Refactor cycle

No licenceAuto-check: notesTesting & QA

Install Long Task TDD

skills CLI
$ npx skills add suriyel/longtaskforagent --skill long-task-tdd -a claude-code

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

GitHub CLI
$ gh skill install suriyel/longtaskforagent long-task-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/suriyel/longtaskforagent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/long-task-tdd .claude/skills/long-task-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/

Facts

Skill name
long-task-tdd
GitHub stars
177
Token cost
~4.4k tokens
SKILL.md length
2,177 words
Files
5 (incl. references)
Skills in repo
17
Repo updated
First seen
Licence
None found

At a glance

A skill your agent uses when implementing a feature through TDD in a long-task project - enforces Red-Green-Refactor cycle

  • Works in 3 steps: TDD Red — Write Failing Tests → TDD Green — Minimal Implementation → TDD Refactor
  • Implementing a feature through TDD in a long-task project - enforces Red-Green-Refactor cycle
  • SKILL.md covers The Iron Law, Red-Green-Refactor Cycle, Step 1: TDD Red — Write… and Step 2: TDD Green — Minimal…, plus 3 more sections
  • Calls python, bash and npx

What it does

Long Task TDD is an agent skill from suriyel/longtaskforagent. Use when implementing a feature through TDD in a long-task project - enforces Red-Green-Refactor cycle

Its SKILL.md is about 4.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including reference files (for example `prompts/implementer-prompt.md`, `references/ui-error-detection.md` and `testing-anti-patterns.md`).

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

When your agent uses it

  • Implementing a feature through TDD in a long-task project - enforces Red-Green-Refactor cycle
  • Tasks that involve Test-driven development

Example prompts

  • “/long-task-tdd”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. TDD Red — Write Failing Tests
  2. TDD Green — Minimal Implementation
  3. TDD Refactor

What it can do on your machine

Read from SKILL.md and the folder at commit ca67fe1. 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

    Shell commands in SKILL.md call:

    • python
    • bash
    • npx
    • mvn
    • mypy

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

    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

Long Task TDD loads about 4.4k tokens when it runs, and up to ~8.2k if it reads all its reference files. Until then it costs about 29 tokens; SKILL.md has 2,177 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:155
    ucture** | Use project test environment (.env.test, test DB, localhost test server) — never production resources |

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 2,177 words (~4,423 tokens).

“Write the test first. Watch it fail. Write minimal code to pass. Refactor.”

— opening of SKILL.md by suriyel
name
long-task-tdd

Read the full SKILL.md on GitHub

Files

SKILL.md and 4 other files (references) in skills/long-task-tdd of suriyel/longtaskforagent.

  • SKILL.md
  • SKILL.md.template
  • prompts/implementer-prompt.md
  • references/ui-error-detection.md
  • testing-anti-patterns.md

Open the folder on GitHubat commit ca67fe1

Compare with similar skills

Long Task 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.

Long Task TDD compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Long Task TDD this skillsuriyel/longtaskforagent177—~4.4kAutomated safety check: NotesNone
TDDpietheinstrengholt/rssmonster56430 repos~906Automated safety check: PassMIT
TDD WorkflowhellangleZ/burn-in-cceverywhere-ralph11211 repos~2.4kAutomated safety check: PassNone
TDDsanity-io/sanity6.4k20 repos~1kAutomated safety check: PassMIT
Test Driven Developmentfarm-fe/farm5.6k51 repos~2.5kAutomated safety check: PassMIT
Tapd Story PipelineTencentBlueKing/bk-bcs840—~2.6kAutomated safety check: PassCustom licence

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
  • 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 suriyel/longtaskforagent

All 17 skills in this repo
  • Long Task Init

    suriyel/longtaskforagent

    A skill your agent uses when ATS doc exists (or auto-skipped) but feature-list.json not yet created - scaffold project artifacts and populate features from Design §10.2

    177 GitHub stars~5.6k tokensUpdated 3 mo ago
    Auto-check: notes
  • Long Task Explore

    suriyel/longtaskforagent

    A skill your agent uses for on-demand deep exploration of an existing codebase - analyzes architecture, data flow, domain model, API surface, dependencies, and code health

    177 GitHub stars~2.7k tokensUpdated 3 mo ago
    Auto-check passed
  • Using Long Task

    suriyel/longtaskforagent

    A skill your agent uses when starting any session in a long-task project - routes to the correct phase skill based on project state

    177 GitHub stars~3.6k tokensUpdated 3 mo ago
    Auto-check passed
  • Long Task Ats

    suriyel/longtaskforagent

    A skill your agent uses when design doc exists but no ATS doc and no feature-list.json - generate a global Acceptance Test Strategy mapping every requirement to acceptance scenarios with category…

    177 GitHub stars~3.7k tokensUpdated 3 mo ago
    Auto-check passed
  • Long Task Design

    suriyel/longtaskforagent

    A skill your agent uses when SRS doc exists but no design doc and no feature-list.json - take the approved SRS as input and produce an architecture/design document focused on HOW to build it

    177 GitHub stars~4.5k tokensUpdated 3 mo ago
    Auto-check passed
  • Long Task Hotfix

    suriyel/longtaskforagent

    A skill your agent uses when bugfix-request.json exists - validate, reproduce, root-cause, and enqueue a user-reported bug as a category=bugfix feature, then chain to Worker for TDD fix

    177 GitHub stars~2.2k tokensUpdated 3 mo ago
    Auto-check passed

Categories

Questions about Long Task TDD

What does Long Task TDD do?

A skill your agent uses when implementing a feature through TDD in a long-task project - enforces Red-Green-Refactor cycle. Long Task TDD is an agent skill from suriyel/longtaskforagent.

When should I use Long Task TDD?

Long Task TDD fits situations like: implementing a feature through TDD in a long-task project - enforces Red-Green-Refactor cycle; tasks that involve Test-driven development.

How do I install Long Task TDD in Claude Code?

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

How do I install Long Task TDD in Codex?

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

Can I use Long Task 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 suriyel/longtaskforagent --skill long-task-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/long-task-tdd, .gemini/skills/long-task-tdd, .github/skills/long-task-tdd and .opencode/skills/long-task-tdd in your project.

What does Long Task TDD need to run?

Going by SKILL.md and its folder, Long Task TDD needs the command-line tools its instructions call (python, bash, npx, mvn and mypy). Our summary lists: Python 3.

Does Long Task TDD access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Long Task TDD safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Long Task TDD use?

No licence was found for Long Task TDD or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Long Task TDD use?

About 4.4k tokens (SKILL.md is roughly 18k 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 3.8k tokens, read only when the agent opens those files.

What are the alternatives to Long Task TDD?

Skills that share tags, products or a category with Long Task 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 Long Task TDD?

suriyel (a GitHub user) maintains it in suriyel/longtaskforagent, which has 177 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on June 23, 2026.

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