writing-tests

Write and run unit, integration, and acceptance tests for code changes.

Updated Dec 31, 2025
One-click install
npx skills add https://github.com/tomgun/agentic-framework --skill writing-tests-tomgun
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-tests
Source: https://github.com/tomgun/agentic-framework/tree/main/.agentic/lib/agents/claude/skills/writing-tests
Command: npx skills add https://github.com/tomgun/agentic-framework --skill writing-tests-tomgun

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill reduces the risk of regressions and incomplete acceptance by guiding the creation, execution, and verification of tests for new features and bug fixes.

Core Features & Use Cases

  • Acceptance-driven test design: Read acceptance criteria and translate them into focused test cases covering happy path, edge cases, and error handling.
  • Project-aligned test authoring: Follow repository conventions, test naming, and framework patterns to integrate new tests cleanly.
  • Execution and verification: Run tests using the project's test runner, confirm new tests pass, and ensure no existing tests are broken.
  • Use Case: Add unit and integration tests for a recently implemented feature to ensure all acceptance criteria are validated and prevent future regressions.

Quick Start

Run a focused test development session: read the relevant acceptance file, write targeted tests following project conventions, and execute them to confirm all criteria pass.

Frequently Asked Questions about writing-tests

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

FAQPage Schema
How do I write tests to prevent regressions for a new feature implementation?

To prevent regressions, read the feature's acceptance criteria and translate them into focused unit, integration, and acceptance tests covering happy path, edge cases, and error handling. Follow repository conventions to integrate new tests cleanly into the project framework.

What is the best way to run tests and verify acceptance criteria after a bug fix?

Run tests using the project's test runner via a shell-capable environment to verify acceptance criteria. Execute the targeted test cases to confirm new tests pass and ensure no existing tests are broken during bug fixes.

How do I structure unit and integration tests to match existing repository conventions?

Structure unit and integration tests by following existing repository conventions, test naming patterns, and framework configurations. Align new test authoring with project patterns to ensure tests integrate cleanly without breaking current test suites.

Do I need a specific test framework to execute tests and report failures for code changes?

You need access to the project's existing test frameworks and repository files. A shell-capable runner is required to execute test commands and report failures accurately for verifying code changes and preventing regressions.

Why does my test suite break when adding new tests for feature implementations?

Test suites break when new tests do not follow repository conventions or conflict with existing test patterns. Ensure new tests align with project framework configurations and run the full test suite to confirm no existing tests are broken.

Can I generate acceptance tests automatically from acceptance criteria for regression testing?

Acceptance tests are created by reading acceptance criteria and translating them into focused test cases. This process covers happy path, edge cases, and error handling to validate criteria and prevent future regressions.