local-service-testing

Enforce integration tests against local databases, caches, and queues.

10|Updated Jan 7, 2026
One-click install
npx skills add https://github.com/troykelly/codex-skills --skill local-service-testing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: local-service-testing
Source: https://github.com/troykelly/codex-skills/tree/main/skills/local-service-testing
Command: npx skills add https://github.com/troykelly/codex-skills --skill local-service-testing

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures that code changes affecting service-dependent components are tested against actual local services, preventing bugs that would otherwise only be discovered in CI.

Core Features & Use Cases

  • Mandatory Integration Testing: Enforces testing against real databases, caches, and queues, not just mocks.
  • Service Dependency Identification: Helps identify which services your changes interact with.
  • Artifact Requirement: Requires posting local testing evidence to the issue before PR creation.
  • Use Case: When modifying database models, you must run integration tests against a live PostgreSQL instance to catch schema or constraint violations that mocks would miss.

Quick Start

Ensure all required local services are running and then execute your integration test suite.

Frequently Asked Questions about local-service-testing

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

FAQPage Schema
How do I enforce integration testing against real local services before a pull request?

To enforce integration testing before a pull request, this Skill identifies service dependencies from changed files and requires a local testing artifact to be posted to the issue prior to PR creation. This ensures changes are validated against actual local services.

Why should I test database changes against real local services instead of mocks?

Testing against real local services catches schema or constraint violations that mocks would miss. By mandating integration tests against live instances like databases and caches, you prevent bugs that would otherwise only be discovered later in the CI pipeline.

How do I identify which local service dependencies my code changes interact with?

You can identify local service dependencies by analyzing your changed files. This Skill automatically detects which databases, caches, or queues your modifications interact with to mandate corresponding integration tests using tools like docker-compose.

Can I use docker-compose to run integration tests for local service dependencies?

Yes, you can use docker-compose to run integration tests for local service dependencies. The Skill mandates testing code changes against actual local services like databases and queues using orchestration tools to validate behavior before allowing a pull request.

What is the best way to prevent service-dependent bugs from reaching CI?

The best way to prevent service-dependent bugs from reaching CI is enforcing local integration testing. This Skill requires running tests against real local services and posting a local testing artifact to the issue before PR creation to verify stability.

Do I need to post a local testing artifact to the issue before creating a PR?

Yes, you must post a local testing artifact to the issue before creating a PR. This requirement ensures that code changes affecting service-dependent components have been successfully tested against real local services like databases and caches.