smoke-test

Generate minimal smoke tests from OpenAPI/Swagger specs and SPEC data.

1|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/cr330326/AgentSkill --skill smoke-test-cr330326
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: smoke-test
Source: https://github.com/cr330326/AgentSkill/tree/main/validate/smoke-test
Command: npx skills add https://github.com/cr330326/AgentSkill --skill smoke-test-cr330326

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yaml, pypdf, and includes scripts (resource) and references (resource) components.

What problem does it solve?

从 SPEC 与 OpenAPI/Swagger 生成最小可执行的冒烟测试,并在用户确认后对目标服务执行。该技能聚焦于快速、低风险的验证,避免完整回归、性能测试或安全测试的复杂性。

Core Features & Use Cases

  • 基于 OpenAPI/Swagger 与 SPEC 数据生成最小化的冒烟测试套件,用于快速验证已部署的服务。
  • 通过端点范围筛选(健康检查、只读、无路径参数等)实现安全且高相关性的测试集合。
  • 在隔离工作区输出测试文件与清单(manifest),并在执行前后保留可追溯的结果。
  • 仅在用户明确同意后执行测试,支持加载输入契约与执行策略以确保安全边界。

Quick Start

Run the smoke-test generator against your OpenAPI spec to produce tests and a manifest, then review them before executing against a live service.

Frequently Asked Questions about smoke-test

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

FAQPage Schema
How do I generate smoke tests from an OpenAPI or Swagger spec?▼

To generate smoke tests from OpenAPI or Swagger specs, this Skill creates minimal executable test suites by parsing the provided spec data and applying scope-based endpoint selection for safe, high-relevance validation. It outputs test files and a structured manifest for traceability.

What is the best way to run a quick health check on deployed APIs?▼

The best way to run a quick health check on deployed APIs is generating minimal smoke tests from OpenAPI specs. This approach filters endpoints by scope, such as health checks and read-only routes, ensuring low-risk baseline verification before requesting explicit user execution.

Can I automatically execute generated API tests against a live service?▼

You cannot automatically execute generated API tests against a live service without explicit user confirmation. This Skill enforces safety boundaries by requiring user approval before running tests on deployed services, ensuring safe pre-release checks and baseline health verification.

Does smoke testing work with endpoints that have path parameters?▼

Smoke testing with this Skill filters out endpoints with path parameters by default during scope-based endpoint selection. It focuses on minimal, low-risk validation like health checks and read-only operations to ensure safe baseline health verification for deployed services.

What is included in the test manifest output after generating API smoke tests?▼

The test manifest output includes structured results for traceability, retaining records before and after test execution. It documents the generated minimal smoke tests, input contracts, execution policies, and scope-based endpoint selection from your OpenAPI or Swagger spec data.

When should I not use minimal smoke tests for API validation?▼

You should not use minimal smoke tests for complete regression, performance testing, or security testing. This Skill focuses strictly on quick, low-risk post-deployment validation and baseline health verification, avoiding the complexity of comprehensive test suites.