api-smoke-validation

Automate API smoke tests for auth, status codes, and response shapes with hurl.

1|1|Updated May 3, 2026
One-click install
npx skills add https://github.com/matt-riley/agent-skills --skill api-smoke-validation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-smoke-validation
Source: https://github.com/matt-riley/agent-skills/tree/main/skills/api-smoke-validation
Command: npx skills add https://github.com/matt-riley/agent-skills --skill api-smoke-validation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Quickly validate API health by running deterministic smoke tests to catch regressions in authentication, status codes, and response shapes using a lightweight approach.

Core Features & Use Cases

  • Deterministic smoke scenarios for health endpoints, auth flows, and critical paths
  • Reusable HTTP requests with explicit status and header assertions suitable for CI and local runs
  • Lightweight health-check suite that can be adapted for branch-level validation and quick feedback

Quick Start

Configure your target base URL and auth, add your first smoke hurl file, and run hurl to execute the quick checks.

Frequently Asked Questions about api-smoke-validation

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

FAQPage Schema
How do I automate API smoke tests to verify status codes and auth after a deployment?

You can automate API smoke tests by running deterministic hurl scenarios that verify authentication, status codes, and response shapes across REST and HTTP APIs. This provides quick post-change sanity checks and lightweight health validations.

Can I use hurl for CI smoke runs on my REST APIs?

Yes, hurl can be used for CI smoke runs on REST APIs by executing reusable HTTP requests with explicit status and header assertions. It applies to branch-level validation and provides quick feedback during continuous integration.

What is API smoke testing and when do I need it?

API smoke testing is a lightweight health validation process that runs deterministic checks on critical paths to catch regressions early. You need it for post-change sanity checks and verifying endpoint health without executing full test suites.

How do I set up hurl to validate response shapes and endpoint health?

You set up hurl by configuring your target base URL and authentication, adding a smoke hurl file with explicit assertions, and running hurl to execute the quick checks. This validates response shapes and endpoint health deterministically.

Does this API smoke testing approach work for lightweight health checks?

Yes, this approach works for lightweight health checks by applying deterministic smoke scenarios to health endpoints and critical paths. It provides a fast, repeatable method for verifying API health without the overhead of comprehensive testing.