Agent skill

Wiremock Standalone Docker

by giuseppe-trisciuoglio in giuseppe-trisciuoglio/developer-kit

Provides patterns and configurations for running WireMock as a standalone Docker container.

MITAuto-check: notesDevOps & Cloud

Install Wiremock Standalone Docker

skills CLI
$ npx skills add giuseppe-trisciuoglio/developer-kit --skill wiremock-standalone-docker -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install giuseppe-trisciuoglio/developer-kit wiremock-standalone-docker --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/giuseppe-trisciuoglio/developer-kit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/developer-kit-java/skills/wiremock-standalone-docker .claude/skills/wiremock-standalone-docker && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
wiremock-standalone-docker
GitHub stars
357
Token cost
~1.2k tokens
SKILL.md length
419 words
Files
11 (incl. references)
Skills in repo
115
Repo updated
First seen
Licence
MIT

At a glance

Provides patterns and configurations for running WireMock as a standalone Docker container.

  • Works in 7 steps: Set Up Docker Compose → Create Directory Structure → Define API Mappings → …
  • You need to mock APIs
  • SKILL.md covers Overview, When to Use, Instructions and Examples, plus 4 more sections
  • Calls docker and curl

What it does

Wiremock Standalone Docker is an agent skill from giuseppe-trisciuoglio/developer-kit. Provides patterns and configurations for running WireMock as a standalone Docker container. Generates mock HTTP endpoints, creates stub mappings for testing, validates integration scenarios, and simulates error conditions. Use when you need to mock APIs, create a mock server, stub external services, simulate third-party APIs, or fake API responses for integration testing.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 13 other files, including reference files (for example `references/docker-compose.yml`, `references/wiremock/mappings/delete-forbidden.json` and `references/wiremock/mappings/get-dynamic-response.json`).

It sits in DevOps & Cloud, covering Containers, Third-party API integration and Integration testing. It works with Docker. The repository describes itself as: Modular plugin marketplace for Claude Code and agentic CLIs, with validated, spec-driven skills, agents, commands, and workflows for Java, TypeScript, Python, PHP, AWS, and AI. The licence is MIT.

When your agent uses it

  • You need to mock APIs
  • Create a mock server
  • Stub external services
  • Simulate third-party APIs

Example prompts

  • “Use the wiremock-standalone-docker skill to provide patterns and configurations for running WireMock as a standalone Docker container”
  • “/wiremock-standalone-docker”

Requirements

  • Docker
  • Pre-approved tools (allowed-tools): Read, Write, Edit, Bash, Glob, Grep

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Set Up Docker Compose
  2. Create Directory Structure
  3. Define API Mappings
  4. Start WireMock
  5. Verify WireMock is Running
  6. Configure HTTP Client
  7. Test Edge Cases

What it can do on your machine

Read from SKILL.md and the folder at commit fe73fb3. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Bash
    • Glob
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • docker
    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use docker and curl, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Wiremock Standalone Docker loads about 1.2k tokens when it runs, and up to ~2k if it reads all its reference files. Until then it costs about 100 tokens; SKILL.md has 419 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~100
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Write, Edit, Bash, Glob, Grep

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from giuseppe-trisciuoglio/developer-kit at commit fe73fb3, republished under its MIT licence (© giuseppe-trisciuoglio). 419 words, ~1,222 tokens.

Download SKILL.mdSave it as .claude/skills/wiremock-standalone-docker/SKILL.md (or your agent's skills folder). This skill also uses 10 other files; get the full folder from GitHub.
name
wiremock-standalone-docker
description
Provides patterns and configurations for running WireMock as a standalone Docker container. Generates mock HTTP endpoints, creates stub mappings for testing, validates integration scenarios, and simulates error conditions. Use when you need to mock APIs, create a mock server, stub external services, simulate third-party APIs, or fake API responses for integration testing.
allowed-tools
Read, Write, Edit, Bash, Glob, Grep

WireMock Standalone Docker Skill

Overview

Provides patterns for running WireMock as a standalone Docker container to mock external APIs during integration and end-to-end testing. Runs WireMock as a separate service that simulates real API behavior for testing HTTP clients, retry logic, and error handling.

When to Use

Use when you need to:

  • Mock external APIs during integration or end-to-end testing
  • Simulate error conditions (timeouts, 5xx, rate limiting) without real services
  • Test HTTP client configurations, retry logic, and error handling
  • Create portable, reproducible test environments
  • Validate API contracts before implementing the real service

Instructions

Step 1: Set Up Docker Compose

Create a docker-compose.yml with WireMock 3.5.2, port mapping, and volume mounts for mappings and files:

yaml
version: "3.8"
services:
  wiremock:
    image: wiremock/wiremock:3.5.2
    ports:
      - "8080:8080"
    volumes:
      - ./wiremock:/home/wiremock
    command: ["--global-response-templating"]
Step 2: Create Directory Structure

Create the WireMock configuration directories:

wiremock/
├── mappings/   # JSON stub definitions
└── __files/   # Response body files
Step 3: Define API Mappings

Create JSON stub files in wiremock/mappings/ for each scenario:

  • Success: Return 200 with JSON body
  • Not Found: Return 404
  • Server Error: Return 500
  • Timeout: Use fixedDelayMilliseconds
  • Rate Limit: Return 429 with Retry-After header
Step 4: Start WireMock
bash
docker compose up -d
Step 5: Verify WireMock is Running
bash
curl http://localhost:8080/__admin/mappings

Expected: Returns empty array {"mappings":[]} if no stubs loaded, or your stub definitions. If you get connection refused, check that the container is running: docker compose ps

Step 6: Configure HTTP Client

Point your application to http://localhost:8080 (or http://wiremock:8080 in Docker network) instead of the real API.

Step 7: Test Edge Cases

Always test: 200, 400, 401, 403, 404, 429, 500, timeouts, malformed responses.

Examples

Example 1: Mock Successful GET Request
json
{
  "request": { "method": "GET", "url": "/api/users/123" },
  "response": {
    "status": 200,
    "jsonBody": { "id": 123, "name": "Mario Rossi" }
  }
}
Example 2: Mock Server Error
json
{
  "request": { "method": "GET", "url": "/api/error" },
  "response": { "status": 500, "body": "Internal Server Error" }
}
Example 3: Mock Timeout
json
{
  "request": { "method": "GET", "url": "/api/slow" },
  "response": {
    "status": 200,
    "fixedDelayMilliseconds": 5000,
    "jsonBody": { "message": "delayed" }
  }
}
Show full SKILL.md (167 more words)Show less
Example 4: Docker Compose with Application
yaml
services:
  wiremock:
    image: wiremock/wiremock:3.5.2
    ports:
      - "8080:8080"
    volumes:
      - ./wiremock:/home/wiremock

  app:
    build: .
    environment:
      - API_BASE_URL=http://wiremock:8080
    depends_on:
      - wiremock

Best Practices

  1. Organize mappings by feature: Use subdirectories like users/, products/
  2. Version control mappings: Keep mappings in git for reproducible tests
  3. Test all error scenarios: 401, 403, 404, 429, 500, timeouts
  4. Reset between test runs: curl -X POST http://localhost:8080/__admin/reset
  5. Use descriptive file names: get-user-success.json, post-user-error.json

Constraints and Warnings

  • Ensure port 8080 is available or map to a different port
  • Configure Docker networking when running multiple containers
  • Enable --global-response-templating for dynamic responses
  • WireMock resets mappings on container restart

Troubleshooting

Requests don't match stubs? Check what WireMock received: curl http://localhost:8080/__admin/requests — shows unmatched requests with details about what was actually sent.

Stub file not loading? Verify file location: place JSON stubs in wiremock/mappings/ and response files in wiremock/__files/. Check file permissions.

Connection refused errors? Run docker compose ps to verify the container is running. Check port conflicts with lsof -i :8080.

References

See references/ for complete examples:

  • docker-compose.yml - Full Docker Compose configuration
  • wiremock/mappings/ - Complete stub examples for all scenarios

© giuseppe-trisciuoglio, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 10 other files (references) in plugins/developer-kit-java/skills/wiremock-standalone-docker of giuseppe-trisciuoglio/developer-kit.

  • SKILL.md
  • references/docker-compose.yml
  • references/wiremock/mappings/delete-forbidden.json
  • references/wiremock/mappings/get-dynamic-response.json
  • references/wiremock/mappings/get-malformed.json
  • references/wiremock/mappings/get-rate-limited.json
  • references/wiremock/mappings/get-unauthorized.json
  • references/wiremock/mappings/get-user-internal-error.json
  • references/wiremock/mappings/get-user-not-found.json
  • references/wiremock/mappings/get-user-slow-response.json
  • references/wiremock/mappings/get-user-success.json

Open the folder on GitHubat commit fe73fb3

Compare with similar skills

Wiremock Standalone Docker next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Wiremock Standalone Docker compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Wiremock Standalone Docker this skillgiuseppe-trisciuoglio/developer-kit357—~1.2kAutomated safety check: NotesMIT
Cb Build TestBlkLeg/CircuitBreaker201—~1.9kAutomated safety check: PassMIT
Ak Dev New Sandbox Provideryaalalabs/agent-kernel192—~3.7kAutomated safety check: PassApache-2.0
Test Environmentspetrkindlmann/qa-skills170—~4.6kAutomated safety check: PassMIT
Safactory WorkflowsAI45Lab/SAfactory236—~1.8kAutomated safety check: PassNone
Benchflow Experiment Reviewbenchflow-ai/benchflow356—~4kAutomated safety check: PassApache-2.0

Similar skills

  • Cb Build Test

    BlkLeg/CircuitBreaker

    How Circuit Breaker is built, tested, packaged, and kept secret-safe — the make dev/verify/test targets, the PostgreSQL integration test database and its fixtures, the mono Docker image and native…

    201 GitHub stars~1.9k tokensUpdated 5 days ago
    DevOps & CloudAuto-check passed
  • Ak Dev New Sandbox Provider

    yaalalabs/agent-kernel

    Step-by-step guide for adding a new sandbox provider to Agent Kernel.

    192 GitHub stars~3.7k tokensUpdated 2 days ago
    DevOps & CloudAuto-check passed
  • Test Environments

    petrkindlmann/qa-skills

    Design environment strategy for testing across dev, CI, preview, staging, and production — Docker Compose test infrastructure, multi-stage Dockerfiles, seed-data lifecycle, per-PR preview…

    170 GitHub stars~4.6k tokensUpdated 4 mo ago
    DevOps & CloudAuto-check passed
  • Safactory Workflows

    AI45Lab/SAfactory

    Integrate a benchmark or custom environment into SAfactory using fixed adapter templates and local contract tests, optionally run Docker/RJob evaluation, or prepare GRPO/RL training.

    236 GitHub stars~1.8k tokensUpdated 17 days ago
    AI & LLM EngineeringAuto-check passed
  • Benchflow Experiment Review

    benchflow-ai/benchflow

    Review Benchflow or SkillsBench task-run trajectories and integration-test Benchflow code changes.

    356 GitHub stars~4k tokensUpdated 5 days ago
    Testing & QAAuto-check passed
  • Official

    Migrate a Testcontainers guide from testcontainers.com into the Docker docs site (docs.docker.com).

    4.7k GitHub stars~5k tokensUpdated yesterday
    Testing & QAAuto-check passed

More from giuseppe-trisciuoglio/developer-kit

All 115 skills in this repo
  • Nestjs Drizzle Crud Generator

    giuseppe-trisciuoglio/developer-kit

    Generates complete CRUD modules for NestJS applications with Drizzle ORM.

    357 GitHub stars~1.3k tokensUpdated 1 mo ago
    Auto-check: notes
  • Spring Boot Actuator

    giuseppe-trisciuoglio/developer-kit

    Provides patterns to configure Spring Boot Actuator for production-grade monitoring, health probes, secured management endpoints, and Micrometer metrics across JVM services.

    357 GitHub stars~2.2k tokensUpdated 1 mo ago
    Auto-check: notes
  • Spring Boot Crud Patterns

    giuseppe-trisciuoglio/developer-kit

    Provides and generates complete CRUD workflows for Spring Boot 3 services.

    357 GitHub stars~2.5k tokensUpdated 1 mo ago
    Auto-check: notes
  • Spring Boot Security JWT

    giuseppe-trisciuoglio/developer-kit

    Provides JWT authentication and authorization patterns for Spring Boot 3.5.x covering token generation with JJWT, Bearer/cookie authentication, database/OAuth2 integration, and RBAC/permission-based…

    357 GitHub stars~3.9k tokensUpdated 1 mo ago
    Auto-check: notes
  • AWS CLI Beast

    giuseppe-trisciuoglio/developer-kit

    Provides advanced AWS CLI patterns for managing EC2, Lambda, S3, DynamoDB, RDS, VPC, IAM, and CloudWatch.

    357 GitHub stars~1.7k tokensUpdated 1 mo ago
    Auto-check: notes
  • PR Review Comments

    giuseppe-trisciuoglio/developer-kit

    Posts review findings from a JSON file as inline comments on a GitHub Pull Request, attaching each comment to its file and line.

    357 GitHub stars~1k tokensUpdated 1 mo ago
    Auto-check: notes

Works with

Categories

Questions about Wiremock Standalone Docker

What does Wiremock Standalone Docker do?

Provides patterns and configurations for running WireMock as a standalone Docker container. Wiremock Standalone Docker is an agent skill from giuseppe-trisciuoglio/developer-kit. Provides patterns and configurations for running WireMock as a standalone Docker container.

When should I use Wiremock Standalone Docker?

Wiremock Standalone Docker fits situations like: you need to mock APIs; create a mock server; stub external services; simulate third-party APIs.

How do I install Wiremock Standalone Docker in Claude Code?

Run `npx skills add giuseppe-trisciuoglio/developer-kit --skill wiremock-standalone-docker -a claude-code`. Or copy the skill folder (plugins/developer-kit-java/skills/wiremock-standalone-docker in giuseppe-trisciuoglio/developer-kit) into .claude/skills/wiremock-standalone-docker in your project. Claude Code loads it when a task matches its description.

How do I install Wiremock Standalone Docker in Codex?

Run `npx skills add giuseppe-trisciuoglio/developer-kit --skill wiremock-standalone-docker -a codex`. Or copy the skill folder (plugins/developer-kit-java/skills/wiremock-standalone-docker in giuseppe-trisciuoglio/developer-kit) into .agents/skills/wiremock-standalone-docker in your project. Codex loads it when a task matches its description.

Can I use Wiremock Standalone Docker in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add giuseppe-trisciuoglio/developer-kit --skill wiremock-standalone-docker -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/wiremock-standalone-docker, .gemini/skills/wiremock-standalone-docker, .github/skills/wiremock-standalone-docker and .opencode/skills/wiremock-standalone-docker in your project.

What does Wiremock Standalone Docker need to run?

Going by SKILL.md and its folder, Wiremock Standalone Docker needs the command-line tools its instructions call (docker and curl). Our summary lists: Docker. Its frontmatter pre-approves these tools: Read, Write, Edit, Bash, Glob, Grep.

Does Wiremock Standalone Docker access the network?

SKILL.md contains no URLs. Its commands use docker and curl, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Wiremock Standalone Docker safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Wiremock Standalone Docker use?

Wiremock Standalone Docker is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Wiremock Standalone Docker use?

About 1.2k tokens (SKILL.md is roughly 4.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 805 tokens, read only when the agent opens those files.

What are the alternatives to Wiremock Standalone Docker?

Skills that share tags, products or a category with Wiremock Standalone Docker: Cb Build Test (BlkLeg/CircuitBreaker, 201 stars), Ak Dev New Sandbox Provider (yaalalabs/agent-kernel, 192 stars), Test Environments (petrkindlmann/qa-skills, 170 stars) and Safactory Workflows (AI45Lab/SAfactory, 236 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Wiremock Standalone Docker?

giuseppe-trisciuoglio (a GitHub user) maintains it in giuseppe-trisciuoglio/developer-kit, which has 357 GitHub stars. The repository holds 115 skills in this directory. The repository was last updated on September 10, 2026.

Source: giuseppe-trisciuoglio/developer-kit on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.