runtime-behavior-probe

Plan and execute runtime behavior investigations with validation matrices and findings-first reports.

Updated May 23, 2026
One-click install
npx skills add https://github.com/kiranimmadi2/promptforge-ai --skill runtime-behavior-probe-kiranimmadi2
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: runtime-behavior-probe
Source: https://github.com/kiranimmadi2/promptforge-ai/tree/main/openai-agents-python/.agents/skills/runtime-behavior-probe
Command: npx skills add https://github.com/kiranimmadi2/promptforge-ai --skill runtime-behavior-probe-kiranimmadi2

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Code review and documentation alone cannot reveal how software actually behaves at runtime. This Skill structures investigations into real runtime behavior—edge cases, undocumented behavior, regressions, and failure modes—using planned probe scripts, validation matrices, and evidence-based reporting instead of guesswork. ## Core Features & Use Cases - Validation Matrix Planning: Design a case matrix covering baseline success, controls, boundary inputs, invalid inputs, transient failures, retries, and concurrency before running anything. - Disposable Probe Scripts: Generate temporary, observable Python probe scripts that capture runtime context such as git commit, Python version, and package versions, with support for repeat-N and warm-up execution modes. - Safe Live Probing: Apply destination, intent, and data gates before live API probes, including explicit approval for environment variables like OPENAI_API_KEY and cleanup or rollback plans for mutating cases. - Findings-First Reporting: Report unexpected or negative findings first, with scope, confidence, comparison parity notes, and artifact status. - Use Case: When you suspect a regression in the OpenAI Agents SDK after a change, use this Skill to run a controlled probe against a known-good baseline like origin/main, compare behavior across repeat runs, and produce an evidence-backed report. ## Quick Start Use the runtime-behavior-probe skill to verify whether streaming retries behave differently after the latest commit, with a control run against origin/main.

Frequently Asked Questions about runtime-behavior-probe

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

FAQPage Schema
How do I verify actual runtime behavior of my code beyond unit tests?

Plan a validation matrix covering baseline, boundary, invalid-input, and failure cases, then execute small disposable probe scripts that capture runtime context and observed results. This Skill structures that workflow and produces a findings-first report with evidence.

How do I test for a suspected regression in the OpenAI Agents SDK?

Add a known-good control case such as origin/main or the latest release alongside the suspected change, keep probe inputs identical, and compare observed behavior. The Skill's workflow enforces this control-based comparison before attributing differences to the change.

Can I run live probes against the OpenAI API safely?

Yes, but only after passing three gates: an allowed destination, explicit user intent, and approval of exact environment variable names such as OPENAI_API_KEY. Mutating or costly cases also require a cleanup or rollback plan before execution.

When should I use repeat-N or warm-up execution modes?

Use repeat-N for cache, retry, streaming, rate-limit, or concurrency questions where run-to-run behavior varies. Use warm-up plus repeat-N when cold-start effects like container provisioning or prompt-cache population could distort first-run results.

What are the limitations of runtime behavior probing?

Probes answer narrow questions and should not replace documentation review or static analysis. Comparative results may support only pattern parity unless harder open-ended cases are added, and live probes require explicit approval and cost consideration.