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
npx skills add LambdaTest/agent-skills --skill testunit-skill -a claude-codeWhat 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::TestCaseclass for a new service - Choose the right assertion for a float comparison
- Split preparation and cleanup into
setupandteardown - Assert that a method raises the expected exception
- Run every
test_*.rbfile with one command
Example prompts for the agent
- Write
Test::Unittests for theCalculatorclass: addition, subtraction and division by zero - Add
assert_instance_ofandassert_respond_tochecks totest_user_service.rb - Set up a transaction fixture in
self.startupwith a rollback inteardown
How to install testunit-skill
1Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill testunit-skill -a claude-code2Manually: put the files in place
~/.claude/skills/testunit-skill/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/testunit-skill/
1Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill testunit-skill -a codex2Manually: put the files in place
.agents/skills/testunit-skill/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill testunit-skill -a cursor2Manually: put the files in place
.cursor/skills/testunit-skill/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install LambdaTest/agent-skills testunit-skill2Manually: put the files in place
.github/skills/testunit-skill/SKILL.md1Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill testunit-skill -a gemini-cli2Platform CLI
gemini skills install https://github.com/LambdaTest/agent-skills --path testunit-skillManually: put the files in place
.devin/skills/testunit-skill/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill testunit-skill -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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