Skip to main content
skill CX Codex

testunit-skill — Claude Code skill: Test::Unit tests in Ruby

testunit-skill generates Test::Unit tests for Ruby projects: xUnit-style classes, assert methods and fixtures. Fits codebases already running on test-unit rather than RSpec.

MIT 213 installs ★ 393 updated 2026-10-13

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add LambdaTest/agent-skills --skill testunit-skill -a claude-code
Open on GitHub

What testunit-skill does

The skill hands the agent a template for classic xUnit testing in Ruby: a class inheriting from Test::Unit::TestCase, methods named test_*, assertions like assert_equal, assert_raise and assert_in_delta. It also carries the full assertion list and shows per-class fixtures through self.startup and self.shutdown, with setup and teardown wrapping each test.

Running the result takes two steps: gem install test-unit, then ruby test/test_calculator.rb or autodiscovery with testrb test/. Advanced patterns and CI notes sit in reference/playbook.md, which the skill points to.

On an RSpec codebase it stays quiet. Triggers are Test::Unit wording and assert_equal, not specs, so existing RSpec suites get nothing from it.

What it helps with

  • Scaffold a Test::Unit::TestCase class for a new service
  • Choose the right assertion for a float comparison
  • Split preparation and cleanup into setup and teardown
  • Assert that a method raises the expected exception
  • Run every test_*.rb file with one command

Example prompts for the agent

  • Write Test::Unit tests for the Calculator class: addition, subtraction and division by zero
  • Add assert_instance_of and assert_respond_to checks to test_user_service.rb
  • Set up a transaction fixture in self.startup with a rollback in teardown

How to install testunit-skill

1Skills CLI (Vercel)

npx skills add LambdaTest/agent-skills --skill testunit-skill -a claude-code

2Manually: put the files in place

~/.claude/skills/testunit-skill/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/testunit-skill/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about testunit-skill

How do I install testunit-skill in Claude Code?

Run npx skills add LambdaTest/agent-skills --skill testunit-skill -a claude-code. The skill file lands at ~/.claude/skills/testunit-skill/SKILL.md.

What does testunit-skill do?

It gives the agent patterns for Test::Unit tests in Ruby: test case classes, the assert method list, fixtures, and the test_ prefix rule for method names.

What do I need to run the tests it writes?

The test-unit gem, installed with gem install test-unit. Run a single file as ruby test/test_calculator.rb, or the whole suite with testrb test/.

Source text

SKILL.md · MIT
---
name: testunit-skill
description: >
  Generates Test::Unit tests in Ruby. Classic xUnit-style testing with assert
  methods and test case classes. Use when user mentions "Test::Unit",
  "assert_equal Ruby", "Ruby test-unit". Triggers on: "Test::Unit",
  "Ruby test-unit", "assert_equal Ruby" (not RSpec).
languages:
  - Ruby
category: unit-testing
license: MIT
metadata:
  author: TestMu AI
  version: "1.0"
---

# Test::Unit Ruby Skill

## Core Patterns

### Basic Test

```ruby
require 'test/unit'

class TestCalculator < Test::Unit::TestCase
  def setup
    @calc = Calculator.new
  end

  def test_addition
    assert_equal(5, @calc.add(2, 3), "2 + 3 should equal 5")
  end

  def test_subtraction
    assert_equal(1, @calc.subtract(3, 2))
  end

  def test_division_by_zero
    assert_raise(ZeroDivisionError) { @calc.divide(10, 0) }
  end

  def test_float_division
    assert_in_delta(3.33, @calc.divide(10, 3), 0.01)
  end

  def teardown
    # cleanup
  end
end
```

### Assertions

```ruby
assert_equal(expected, actual, message = nil)
assert_not_equal(unexpected, actual)
assert_true(value)
assert_false(value)
assert_nil(value)
assert_not_nil(value)
assert_instance_of(klass, obj)
assert_kind_of(klass, obj)
assert_respond_to(obj, :method_name)
assert_match(/pattern/, string)
assert_no_match(/pattern/, string)
assert_include(collection, item)
assert_not_include(collection, item)
assert_empty(collection)
assert_not_empty(collection)
assert_raise(ErrorClass) { block }
assert_nothing_raised { block }
assert_in_delta(expected, actual, delta)
assert_operator(value, :>, 5)
assert_send([obj, :method, arg])
assert_block("message") { condition }
```

### Test Fixtures

```ruby
class TestDatabase < Test::Unit::TestCase
  def self.startup
    # Once before all tests in class
    @@db = Database.connect('test')
  end

  def self.shutdown
    # Once after all tests in class
    @@db.disconnect
  end

  def setup
    # Before each test
    @@db.begin_transaction
  end

  def teardown
    # After each test
    @@db.rollback
  end
end
```

### Test Ordering and Naming

```ruby
class TestUserService < Test::Unit::TestCase
  # Methods must start with 'test_'
  def test_create_user
    user = UserService.create('Alice', '[email protected]')
    assert_not_nil(user)
    assert_equal('Alice', user.name)
  end

  def test_find_user_by_email
    user = UserService.find_by_email('[email protected]')
    assert_instance_of(User, user)
  end
end
```

## Setup: `gem install test-unit`
## Run: `ruby test/test_calculator.rb` or `ruby -Itest -e "Dir.glob('test/**/test_*.rb').each{|f| require f}"`
## Autodiscovery: `testrb test/` (with test-unit gem)

## Deep Patterns

For advanced patterns, debugging guides, CI/CD integration, and best practices,
see `reference/playbook.md`.

© TestMu AI · MIT · LambdaTest/agent-skills

Similar skills

All skills for Testing and QA →

From the same set47

The whole set →

Project sponsors

Companies that keep this analytics open