test-writer

Write tests from roadmap acceptance criteria for RED and GREEN workflows.

Updated Mar 2, 2026
One-click install
npx skills add https://github.com/supermalang/ai-augmented-coding --skill test-writer-supermalang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-writer
Source: https://github.com/supermalang/ai-augmented-coding/tree/main/.claude/skills/test-writer
Command: npx skills add https://github.com/supermalang/ai-augmented-coding --skill test-writer-supermalang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams turn roadmap requirements into executable tests before or after implementation, so acceptance criteria are verified at the right layer without guessing what to cover.

Core Features & Use Cases

  • RED and GREEN TDD modes: Supports writing tests before implementation to prove they fail, then rerunning the same tests after coding to confirm they pass.
  • Layered test coverage: Creates unit, component, integration, accessibility, and end-to-end tests based on what the task changes.
  • Project-specific safety rules: Follows repository conventions for reading roadmap tasks, avoiding implementation reads in RED mode, using real databases for integration tests, and updating roadmap checkboxes.
  • Typical use case: Use it when a backlog item changes a function, UI component, API route, or full user flow and you need the right tests written in the correct place.

Quick Start

Ask the test-writer skill to write RED or GREEN tests for the active roadmap task in docs/ROADMAP.md and follow the repository’s testing, accessibility, and roadmap-update rules.

Frequently Asked Questions about test-writer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn roadmap acceptance criteria into executable tests?

To turn roadmap acceptance criteria into executable tests, provide the active task from your roadmap file, and the system generates unit, component, integration, accessibility, and end-to-end tests based on the specific changes required.

Can I write tests before implementation using TDD red green workflows?

Yes, you can write tests before implementation using TDD red green workflows. In RED mode, it generates tests to prove they fail without reading implementation code, then reruns them in GREEN mode to confirm they pass after coding.

How does test generation handle integration tests and real database connections?

Test generation handles integration tests by requiring strict adherence to project conventions and utilizing real database integration where needed for the active task, ensuring tests verify acceptance criteria accurately at the correct layer.

Do I need to manually update the roadmap checkboxes after generating tests?

No, you do not need to manually update the roadmap checkboxes after generating tests. The process includes automatic roadmap checkbox updates when running in GREEN mode, without modifying your actual implementation code.

What is the best way to ensure accessibility test coverage for UI components?

The best way to ensure accessibility test coverage for UI components is to generate layered tests directly from your roadmap acceptance criteria, which automatically includes accessibility scenarios based on what the specific task changes.

Does test generation work with Vitest and Playwright for end-to-end scenarios?

Yes, test generation works with Vitest and Playwright for end-to-end scenarios. It applies to layered test coverage across unit, component, integration, accessibility, and end-to-end workflows while following your repository's specific testing conventions.