Skills
.Work. You
Rest

surface-testing

Community

Test systems via their surface, not internals.

Software Engineering#testing#cli#observability#end-to-end#http#surface-testing
Authorthrawn01
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Tests are written to exercise the system through its surface — HTTP endpoints, CLI entry points, and exported functions — while avoiding internal function calls. This approach preserves behavior across refactors and ensures users experience the system as intended.

Core Features & Use Cases

  • Enforce testing through the surface that users actually interact with.
  • Support multiple surface types (HTTP, CLI, libraries) and emphasize observability for asynchronous behavior.
  • Provide confidence by validating observable outcomes rather than internals, and by surfacing important metrics when async work is in flight.

Quick Start

Run surface tests against the application to verify public API behavior and end-user outcomes.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: surface-testing
Download link: https://github.com/thrawn01/claude-dotfiles/archive/main.zip#surface-testing

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 510,000+ vetted skills library on demand.