authoring-tests

Guide test file writing with arrange-act-assert and behavior-focused principles.

Updated Mar 9, 2026
One-click install
npx skills add https://github.com/TomerAberbach/claude-config --skill authoring-tests
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: authoring-tests
Source: https://github.com/TomerAberbach/claude-config/tree/main/skills/authoring-tests
Command: npx skills add https://github.com/TomerAberbach/claude-config --skill authoring-tests

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a comprehensive guide and best practices for writing, reviewing, and modifying test files, ensuring robust and maintainable test coverage.

Core Features & Use Cases

  • Test Writing Principles: Offers clear guidelines on structuring tests using arrange-act-assert, focusing on behaviors, and writing descriptive test names.
  • Code Quality: Emphasizes avoiding overspecification, testing public APIs only, and preferring real implementations over mocks.
  • Use Case: When tasked with adding new test coverage for a feature, consult this Skill to ensure the tests are well-written, focused, and adhere to established quality standards.

Quick Start

Follow the principles outlined in this skill when writing new tests.

Frequently Asked Questions about authoring-tests

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

FAQPage Schema
What are the best practices for structuring unit tests?

To structure unit tests effectively, use the arrange-act-assert pattern, write descriptive test names, and focus on testing behaviors rather than internal implementation details to ensure maintainability.

How do I write maintainable integration tests without overspecifying?

To write maintainable integration tests without overspecifying, test public APIs only, focus on behaviors not functions, and prefer using real implementations over mocks to avoid brittle test coverage.

Why should I test behaviors instead of implementation details in software development?

You should test behaviors instead of implementation details in software development because testing public APIs prevents overspecification and ensures your tests remain robust and maintainable during internal refactoring.

When should I prefer real implementations over mocks in my test files?

You should prefer real implementations over mocks in your test files to avoid overspecification and ensure your tests validate actual software behaviors rather than isolated internal functions.

What is the arrange-act-assert pattern for writing test files?

The arrange-act-assert pattern for writing test files is a structuring guideline that separates test setup, execution, and verification to ensure clear, focused, and robust test coverage.