Agent skill

Ambient PR Test

by ambient-code in ambient-code/platform

Deploy a PR's images (api-server, control-plane, runner) to any OpenShift namespace for integration testing.

MITAuto-check passedBackend & APIs

Install Ambient PR Test

skills CLI
$ npx skills add ambient-code/platform --skill ambient-pr-test -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ambient-code/platform ambient-pr-test --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ambient-code/platform.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/control-plane/ambient-pr-test .claude/skills/ambient-pr-test && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ambient-pr-test
GitHub stars
131
Token cost
~1k tokens
SKILL.md length
185 words
Files
2
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

Deploy a PR's images (api-server, control-plane, runner) to any OpenShift namespace for integration testing.

  • Works in 5 steps: Creates DB and app secrets… → Creates CP ServiceAccount + ClusterRole… → Deploys PostgreSQL, api-server (dev… → …
  • Tasks that involve Integration testing
  • SKILL.md covers Environment Detection, Standard OpenShift, MPP Workflow and Troubleshooting
  • Calls bash, curl and python3; reaches quay.io

What it does

Ambient PR Test is an agent skill from ambient-code/platform. Deploy a PR's images (api-server, control-plane, runner) to any OpenShift namespace for integration testing. Works on both standard OpenShift clusters and MPP managed clusters. Auto-detects the environment and chooses the right script.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `evals/evals.json`).

It sits in Backend & APIs, covering Integration testing and Authentication. The repository describes itself as: Vision/Mission https://ambient-code.ai : Virtual team management and collaboration platform. User guides: https://ambient-code.github.io/platform/. The licence is MIT.

When your agent uses it

  • Tasks that involve Integration testing
  • Tasks that involve Authentication

Example prompts

  • “/ambient-pr-test”

Requirements

  • Python 3
  • Docker

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Creates DB and app secrets (auto-generated)
  2. Creates CP ServiceAccount + ClusterRole + ClusterRoleBinding
  3. Deploys PostgreSQL, api-server (dev mode), control-plane (standard mode)
  4. Creates Route (auto-assigned .apps.* host)
  5. Waits for rollouts, smoke-checks health

What it can do on your machine

Read from SKILL.md and the folder at commit 57e8af8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • bash
    • curl
    • python3
    • docker

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • quay.io

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ambient PR Test loads about 1k tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 185 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~63
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ambient-code/platform at commit 57e8af8, republished under its MIT licence (© ambient-code). 185 words, ~1,014 tokens.

Download SKILL.mdSave it as .claude/skills/ambient-pr-test/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
ambient-pr-test
description
Deploy a PR's images (api-server, control-plane, runner) to any OpenShift namespace for integration testing. Works on both standard OpenShift clusters and MPP managed clusters. Auto-detects the environment and chooses the right script.

Ambient PR Test Skill

Deploy PR-tagged Ambient images into an OpenShift namespace for integration testing.

Invoke with a PR URL:

with skills/control-plane/ambient-pr-test  https://github.com/ambient-code/platform/pull/1599

Optional modifiers:

  • --keep-alive — skip teardown
  • deploy-only / teardown-only — single phase
  • --namespace <ns> — target namespace (defaults to current project)

Environment Detection

bash
if oc api-resources --api-group=tenant.paas.redhat.com 2>/dev/null  < /dev/null |  grep -q TenantNamespace; then
  echo "MPP"    # use provision.sh + install.sh
else
  echo "Standard"  # use install-standard.sh
fi
Standard OpenShiftMPP
NamespacePre-existingCreated via TenantNamespace CR
Scriptinstall-standard.shprovision.sh + install.sh
AuthDevelopment (no JWT)Production (RH SSO JWT)
SecretsAuto-generatedCopied from runtime-int

Standard OpenShift

For any cluster where you have oc access and an existing namespace.

Prerequisites
  • oc logged in with create permissions for deployments, services, routes, secrets, ClusterRoles
  • Existing namespace (e.g. mturansk)
  • PR images at quay.io/ambient_code/vteam_*:pr-<NUMBER>
Deploy
bash
PR_NUMBER=1599
NAMESPACE=$(oc project -q)
bash components/pr-test/install-standard.sh "$NAMESPACE" "pr-${PR_NUMBER}"

The script:

  1. Creates DB and app secrets (auto-generated)
  2. Creates CP ServiceAccount + ClusterRole + ClusterRoleBinding
  3. Deploys PostgreSQL, api-server (dev mode), control-plane (standard mode)
  4. Creates Route (auto-assigned .apps.* host)
  5. Waits for rollouts, smoke-checks health
Verify
bash
API_HOST=$(oc get route ambient-api-server -n "$NAMESPACE" -o jsonpath='{.spec.host}')
curl -sk "https://${API_HOST}/api/ambient"
acpctl login --url "https://${API_HOST}"
Teardown
bash
NAMESPACE=$(oc project -q)
oc delete deployment,svc,route,configmap,secret -l app=ambient-api-server -n "$NAMESPACE"
oc delete deployment,svc -l app=ambient-control-plane -n "$NAMESPACE"
oc delete secret ambient-control-plane-token ambient-cp-token-keypair -n "$NAMESPACE" --ignore-not-found
oc delete clusterrole,clusterrolebinding "ambient-control-plane-${NAMESPACE}" --ignore-not-found

MPP Workflow

For MPP clusters (dev-spoke-aws-us-east-1). See components/pr-test/MPP-ENVIRONMENT.md.

bash
PR_NUMBER=1005; ID="pr-${PR_NUMBER}"
bash components/pr-test/build.sh "https://github.com/ambient-code/platform/pull/${PR_NUMBER}"
bash components/pr-test/provision.sh create "$ID"
bash components/pr-test/install.sh "ambient-code--${ID}" "pr-${PR_NUMBER}"
# teardown:
bash components/pr-test/provision.sh destroy "$ID"

Troubleshooting

Images not found

Check quay.io for the tag: https://quay.io/repository/ambient_code/vteam_control_plane?tab=tags

CP can't reach api-server
bash
oc get deployment ambient-control-plane -n "$NAMESPACE" \
  -o jsonpath='{.spec.template.spec.containers[0].env}' | python3 -m json.tool | grep AMBIENT
JWT errors in standard mode

Verify AMBIENT_ENV=development:

bash
oc get deployment ambient-api-server -n "$NAMESPACE" \
  -o jsonpath='{.spec.template.spec.containers[?(@.name=="api-server")].env[?(@.name=="AMBIENT_ENV")].value}'
Route not resolving
bash
oc get route ambient-api-server -n "$NAMESPACE" -o jsonpath='{.spec.host}'
CP keypair secret

Auto-generated on first start as ambient-cp-token-keypair. Check CP logs:

bash
oc logs deployment/ambient-control-plane -n "$NAMESPACE" | grep keypair
Build fails
bash
docker login quay.io  # or: podman login quay.io

© ambient-code, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/control-plane/ambient-pr-test of ambient-code/platform.

  • SKILL.md
  • evals/evals.json

Open the folder on GitHubat commit 57e8af8

Compare with similar skills

Ambient PR Test next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ambient PR Test compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ambient PR Test this skillambient-code/platform131—~1kAutomated safety check: PassMIT
API Testingpetrkindlmann/qa-skills165—~2.7kAutomated safety check: PassMIT
Eval IntegrationIbrahim-3d/orchestrator-supaconductor380—~1.8kAutomated safety check: PassAGPL-3.0
Route Testerblencorp/claude-code-kit106—~3kAutomated safety check: PassMIT
Hybrid Cloud Test Gengetsentry/sentry46k—~2.6kAutomated safety check: PassCustom licence
Contract Testingproffesor-for-testing/agentic-qe494—~1.8kAutomated safety check: PassMIT

Similar skills

  • API Testing

    petrkindlmann/qa-skills

    Test REST and GraphQL APIs with Playwright APIRequestContext, Supertest, or standalone HTTP clients.

    165 GitHub stars~2.7k tokensUpdated 3 mo ago
    Testing & QAAuto-check passed
  • Eval Integration

    Ibrahim-3d/orchestrator-supaconductor

    Specialized integration evaluator for the Evaluate-Loop. An agent skill from Ibrahim-3d/orchestrator-supaconductor.

    380 GitHub stars~1.8k tokensUpdated 10 days ago
    Backend & APIsAuto-check passed
  • Route Tester

    blencorp/claude-code-kit

    Framework-agnostic HTTP API route testing patterns, authentication strategies, and integration testing best practices.

    106 GitHub stars~3k tokensUpdated 10 mo ago
    Backend & APIsAuto-check passed
  • Hybrid Cloud Test Gen

    getsentry/sentry

    Official

    Generate hybrid cloud tests for the Sentry codebase. An agent skill from getsentry/sentry.

    46k GitHub stars~2.6k tokensUpdated today
    Backend & APIsAuto-check passed
  • Contract Testing

    proffesor-for-testing/agentic-qe

    Consumer-driven contract testing for microservices using Pact, schema validation, API versioning, and backward compatibility testing.

    494 GitHub stars~1.8k tokensUpdated 3 days ago
    Backend & APIsAuto-check passed
  • Add delivery controllers for specx services, especially FastAPI HTTP routes.

    202 GitHub stars~704 tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed

More from ambient-code/platform

All 18 skills in this repo
  • Align

    ambient-code/platform

    Run a convention alignment check across the codebase to measure adherence to documented standards.

    131 GitHub stars~754 tokensUpdated today
    Auto-check passed
  • Amber Review

    ambient-code/platform

    Perform a comprehensive code review using repository-specific standards.

    131 GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Cypress Demo

    ambient-code/platform

    Create a Cypress-based video demo for a feature branch with cursor, click effects, and captions.

    131 GitHub stars~879 tokensUpdated today
    Auto-check: notes
  • Deploy

    ambient-code/platform

    Deploy, update manifests, and troubleshoot the ambient-ui component.

    131 GitHub stars~2.6k tokensUpdated today
    Auto-check passed
  • Discover

    ambient-code/platform

    Discover domain-specific skills and context before starting any coding or spec work.

    131 GitHub stars~747 tokensUpdated today
    Auto-check passed
  • Frontend Development

    ambient-code/platform

    Required context for all frontend work. An agent skill from ambient-code/platform.

    131 GitHub stars~525 tokensUpdated today
    Auto-check passed

Questions about Ambient PR Test

What does Ambient PR Test do?

Deploy a PR's images (api-server, control-plane, runner) to any OpenShift namespace for integration testing. Ambient PR Test is an agent skill from ambient-code/platform. Deploy a PR's images (api-server, control-plane, runner) to any OpenShift namespace for integration testing.

When should I use Ambient PR Test?

Ambient PR Test fits situations like: tasks that involve Integration testing; tasks that involve Authentication.

How do I install Ambient PR Test in Claude Code?

Run `npx skills add ambient-code/platform --skill ambient-pr-test -a claude-code`. Or copy the skill folder (skills/control-plane/ambient-pr-test in ambient-code/platform) into .claude/skills/ambient-pr-test in your project. Claude Code loads it when a task matches its description.

How do I install Ambient PR Test in Codex?

Run `npx skills add ambient-code/platform --skill ambient-pr-test -a codex`. Or copy the skill folder (skills/control-plane/ambient-pr-test in ambient-code/platform) into .agents/skills/ambient-pr-test in your project. Codex loads it when a task matches its description.

Can I use Ambient PR Test in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ambient-code/platform --skill ambient-pr-test -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ambient-pr-test, .gemini/skills/ambient-pr-test, .github/skills/ambient-pr-test and .opencode/skills/ambient-pr-test in your project.

What does Ambient PR Test need to run?

Going by SKILL.md and its folder, Ambient PR Test needs the command-line tools its instructions call (bash, curl, python3 and docker). Our summary lists: Python 3; Docker.

Does Ambient PR Test access the network?

SKILL.md names 1 domain. In commands or code: quay.io; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Ambient PR Test safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Ambient PR Test use?

Ambient PR Test is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ambient PR Test use?

About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Ambient PR Test?

Skills that share tags, products or a category with Ambient PR Test: API Testing (petrkindlmann/qa-skills, 165 stars), Eval Integration (Ibrahim-3d/orchestrator-supaconductor, 380 stars), Route Tester (blencorp/claude-code-kit, 106 stars) and Hybrid Cloud Test Gen (getsentry/sentry, 46k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ambient PR Test?

ambient-code (a GitHub organization) maintains it in ambient-code/platform, which has 131 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on October 7, 2026.

Source: ambient-code/platform on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.