solidity-unit-tests

Generate Solidity .tree specs and .t.sol test files for Foundry projects.

1|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/0xHarbs/agent-setup --skill solidity-unit-tests
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: solidity-unit-tests
Source: https://github.com/0xHarbs/agent-setup/tree/main/claude/skills/domain/solidity-unit-tests
Command: npx skills add https://github.com/0xHarbs/agent-setup --skill solidity-unit-tests

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Solidity unit tests for Foundry projects are time-consuming and error-prone; this Skill automates that process using Bulloak BTT to generate specs, scaffold tests, and implement them.

Core Features & Use Cases

  • Analyzes contract functions and generates .tree spec files
  • Scaffolds and implements .t.sol tests guided by Wonderland testing guidelines
  • Supports /solidity-unit-tests, --tree-only, --contract <path>, and --coverage to tailor the workflow

Quick Start

Run /solidity-unit-tests to generate tests for changed contracts.

Frequently Asked Questions about solidity-unit-tests

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

FAQPage Schema
How do I automate Solidity unit tests for Foundry projects?

Automate Solidity unit tests for Foundry projects by generating .tree spec files and scaffolding .t.sol test files using Bulloak BTT. Run the /solidity-unit-tests command to automatically analyze changed contracts and implement test cases.

How do I generate a Bulloak BTT tree spec for Solidity contracts?

Generate a Bulloak BTT tree spec for Solidity contracts by running the test generation workflow with the --tree-only flag. This analyzes contract functions and outputs .tree spec files without scaffolding the full .t.sol test implementations.

Can I target a specific Solidity contract for unit test generation?

Target a specific Solidity contract for unit test generation by passing the --contract <path> flag. This restricts the Bulloak BTT scaffolding and test implementation workflow to a single contract file instead of all changed contracts.

Does the Foundry test generator support coverage flags?

The Foundry test generator supports the --coverage flag to tailor the Bulloak BTT test generation workflow. This adjusts the .t.sol test scaffolding and implementation to prioritize code coverage metrics during automated unit test creation.

What is required to use Bulloak BTT for Solidity test scaffolding?

Using Bulloak BTT for Solidity test scaffolding requires a Foundry-based codebase with a foundry.toml file present. The workflow detects the project structure automatically and applies Wonderland testing guidelines to generate .tree specs and .t.sol test files.

Why are my Foundry unit tests not generating for unchanged contracts?

Foundry unit tests are not generated for unchanged contracts because the default workflow targets modified files to save time. To test unchanged contracts, explicitly specify the target using the --contract <path> flag to force test generation.