| name | test-generator |
| description | Generate test file stubs and boilerplate from source code analysis. Use when the user asks to create tests, add test coverage, or scaffold test files for existing source code.
|
| license | Apache-2.0 |
| compatibility | Requires Deno 2.0+ |
| metadata | {"author":"skillscraft","version":"1.0","category":"testing"} |
Test Generator
When to use this skill
Activate when the user wants to:
- Create test files for existing source code
- Scaffold test stubs with correct imports and structure
- Add test coverage to an untested module
Instructions
- Analyze the source file to extract function and class signatures:
deno run --allow-read scripts/analyze-source.ts <source-file>
- Review the JSON output to understand the public API
- Generate test stubs:
deno run --allow-read --allow-write scripts/generate-stubs.ts <source-file> --output <test-file> --framework vitest
Supported frameworks: vitest (default), jest, mocha
- Fill in the generated test bodies with meaningful assertions
- Run the tests to verify the stubs compile and the structure is correct
Output format
The analysis script outputs:
{
"file": "utils.ts",
"functions": [
{ "name": "formatDate", "params": ["date: Date", "locale?: string"], "returnType": "string", "async": false, "exported": true }
],
"classes": [
{ "name": "UserService", "methods": ["getById", "create", "delete"], "exported": true }
]
}
Gotchas
- Deno 2.0+ is required — these scripts do not run under Node.js
- Analysis uses regex-based parsing, not a full TypeScript compiler — some edge cases may be missed
- Generated tests are stubs with placeholder assertions (
expect(...).toBeDefined()) — fill in real logic
- For framework-specific patterns (mocking, setup/teardown), read
references/TESTING-PATTERNS.md
