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.