add-integration-tests

Generate OpenShift integration deployment tests validating agent /health endpoints.

2|Updated May 27, 2026
One-click install
npx skills add https://github.com/red-hat-data-services/agentic-starter-kits-skills --skill add-integration-tests
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-integration-tests
Source: https://github.com/red-hat-data-services/agentic-starter-kits-skills/tree/main/skills/add-integration-tests
Command: npx skills add https://github.com/red-hat-data-services/agentic-starter-kits-skills --skill add-integration-tests

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Adding reliable integration deployment tests to a new agent is slow and error-prone when you must manually create test scaffolding, wire it into the agent’s Makefile, and update CI coverage.

Core Features & Use Cases

  • Scaffold per-agent integration tests: Creates tests/integration/init.py, conftest.py, and test_deployment.py under agents/<framework>/<agent_name>/tests/integration.
  • Standardized deployment + health verification: Builds and deploys the agent on OpenShift, hits the /health endpoint, and tears down cleanly.
  • CI workflow matrix update: Adds the target agent to .github/workflows/agent-deployment-test.yaml so the new integration test runs in the pipeline.

Quick Start

Ask the agent to add integration deployment tests for agents/<framework>/<agent_name> by running: /agentic-starter-kits-skills:add-integration-tests <agent_path> JIRA-KEY

Frequently Asked Questions about add-integration-tests

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

FAQPage Schema
How do I add integration tests for an agent deployed on OpenShift?

Integration deployment tests validate an agent's /health endpoint by building and deploying the agent on OpenShift, hitting the endpoint, and tearing down cleanly. This verifies your deployment works end-to-end before merging changes.

How do I automate OpenShift deployment health checks in my CI workflow?

You can automate OpenShift deployment health checks by extending the CI workflow matrix entry in .github/workflows/agent-deployment-test.yaml. This adds the target agent to the pipeline so integration tests run automatically on every change.

Do I need pytest to scaffold integration tests for a new agent?

Yes, pytest is required because the scaffolding generates tests/integration/__init__.py, conftest.py, and test_deployment.py under the agent directory. These pytest files handle the build, deploy, verify, and teardown lifecycle for OpenShift health checks.

Can I use this to add health-check coverage for agents in the agentic-starter-kits repository?

Yes, this works specifically for standard agents in the agentic-starter-kits repository. It generates the full integration test scaffolding, updates Makefile test-integration targets, and extends the CI workflow matrix for the selected agent.

What is the best way to wire a new agent's integration tests into a Makefile and CI pipeline?

The best way to wire integration tests into a Makefile and CI pipeline is to generate per-agent pytest scaffolding that updates Makefile test-integration targets and extends the CI workflow matrix entry, ensuring the /health endpoint validation runs automatically.