test-gen

Generate and validate test suites for specified targets using the project's testing framework.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/special-place-administrator/citadel_codex --skill test-gen-special-place-administrator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-gen
Source: https://github.com/special-place-administrator/citadel_codex/tree/main/skills/test-gen
Command: npx skills add https://github.com/special-place-administrator/citadel_codex --skill test-gen-special-place-administrator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generates and validates tests that conform to the project's testing style, ensuring new code paths are covered and tests pass on the first attempt.

Core Features & Use Cases

  • Generates tests for a given target (file, function, or module) based on the project's conventions.
  • Covers happy path, edge cases, and error paths to ensure robust behavior.
  • Enforces a maximum of 3 fix iterations per test file and marks unresolved issues with .skip or .todo as appropriate.

Quick Start

Provide a target (file path, function signature, or module directory) and run the generator to produce a pass-ready test suite.

Frequently Asked Questions about test-gen

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

FAQPage Schema
How do I generate tests that pass on the first try?

To generate tests that pass on the first try, provide a target file, function, or directory. It validates the suite against your project's testing framework and covers happy, edge, and error paths to ensure immediate pass readiness.

What is the best way to automate test generation for specific functions?

Automating test generation for specific functions involves targeting the function signature directly. The generator applies project testing conventions and produces a validated test suite covering robust behavior across all defined code paths.

Do I need a testing framework already configured to generate a test suite?

Yes, you need the project's test harness available to generate a test suite. The generator relies on the existing testing framework to validate generated tests and ensure they conform to the project's specific testing style.

How does test generation handle unresolved edge cases or errors?

Test generation handles unresolved edge cases or errors by marking them with .skip or .todo markers. It enforces a maximum of 3 fix iterations per file, documenting remaining failures rather than leaving broken tests.

Can I generate tests for an entire module directory at once?

Yes, you can generate tests for an entire module directory at once. By providing the directory as the target, the generator applies project testing conventions to ensure comprehensive coverage across all files within that module.