New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Run Uat

by oocx in oocx/tfplan2md

Run User Acceptance Testing by creating a PR with rendered markdown on GitHub or Azure DevOps.

MITAuto-check passedDevOps & Cloud

Install Run Uat

skills CLI
$ npx skills add oocx/tfplan2md --skill run-uat -a claude-code

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

GitHub CLI
$ gh skill install oocx/tfplan2md run-uat --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/oocx/tfplan2md.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/run-uat .claude/skills/run-uat && 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
run-uat
GitHub stars
174
Token cost
~1.2k tokens
SKILL.md length
415 words
Files
1
Skills in repo
28
Repo updated
First seen
Licence
MIT

At a glance

Run User Acceptance Testing by creating a PR with rendered markdown on GitHub or Azure DevOps.

  • Works in 2 steps: Rebase on Latest Main → Generate Fresh Artifacts (if needed)
  • Validating markdown rendering in real platforms
  • SKILL.md covers Purpose, Hard Rules, Pre-requisites and Recommended: Single Wrapper…, plus 4 more sections
  • Calls git, dotnet and gh; needs GH_UAT_TOKEN and AZDO_UAT_TOKEN

What it does

Run Uat is an agent skill from oocx/tfplan2md. Run User Acceptance Testing by creating a PR with rendered markdown on GitHub or Azure DevOps. Use when validating markdown rendering in real platforms.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Requires git. GitHub UAT uses repo scripts which require GitHub CLI (gh) authenticated. Azure DevOps UAT requires Azure CLI (az) + azure-devops extension…

It sits in DevOps & Cloud, covering Markdown. It works with Azure DevOps and GitHub. The repository describes itself as: Convert terraform plans (json) into human readable markdown for easier review of changes in pull requests. The licence is MIT.

When your agent uses it

  • Validating markdown rendering in real platforms
  • Tasks that involve Markdown

Example prompts

  • “/run-uat”

Requirements

  • A credential in GH_UAT_TOKEN
  • A credential in AZDO_UAT_TOKEN
  • Compatibility (from SKILL.md): Requires git. GitHub UAT uses repo scripts which require GitHub CLI (gh) authenticated. Azure DevOps UAT requires Azure CLI (az) + azure-devops extension. Network access required.

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. Rebase on Latest Main
  2. Generate Fresh Artifacts (if needed)

What it can do on your machine

Read from SKILL.md and the folder at commit 88d5240. 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:

    • git
    • dotnet
    • gh

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

  • Network

    No URLs in SKILL.md. Its commands use git and gh, which can reach the network depending on how they are called.

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • GH_UAT_TOKEN
    • AZDO_UAT_TOKEN

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

  • Compatibility

    Requires git. GitHub UAT uses repo scripts which require GitHub CLI (gh) authenticated. Azure DevOps UAT requires Azure CLI (az) + azure-devops extension. Network access required.

    From compatibility in the SKILL.md frontmatter.

Context cost

Run Uat loads about 1.2k tokens when it runs. Until then it costs about 40 tokens; SKILL.md has 415 words of instructions outside code blocks.

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

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 oocx/tfplan2md at commit 88d5240, republished under its MIT licence (© oocx). 415 words, ~1,231 tokens.

Download SKILL.mdSave it as .claude/skills/run-uat/SKILL.md (or your agent's skills folder).
name
run-uat
description
Run User Acceptance Testing by creating a PR with rendered markdown on GitHub or Azure DevOps. Use when validating markdown rendering in real platforms.
compatibility
Requires git. GitHub UAT uses repo scripts which require GitHub CLI (gh) authenticated. Azure DevOps UAT requires Azure CLI (az) + azure-devops extension. Network access required.

Run UAT

Purpose

Execute end-to-end User Acceptance Testing by posting a feature-specific artifact and the comprehensive demo to a real PR on GitHub or Azure DevOps, then validating the rendered output.

Hard Rules

Must
  • Provide at least one --report/--instructions pair (feature-specific report and test instructions).
  • The comprehensive demo is appended automatically — do NOT add it as a --report.
  • Artifacts must be up-to-date (generated from current branch code). Run scripts/generate-demo-artifacts.sh if needed.
  • Leave the UAT PRs open when you finish creating them. Completing the UAT Tester's stage is what opens the Maintainer's approval gate, and the gate asks them to look at those PRs — closing them first makes the gate unanswerable.
  • Cleanup happens after the decision is recorded, and belongs to the Release Manager, not the UAT Tester.
  • Report platform-specific rendering issues clearly.
Must Not
  • Post a minimal or simulation artifact (reject files containing "minimal" or "simulation" in the name).
  • Pass the comprehensive demo as a --report argument (added automatically).
  • Leave UAT PRs open after testing completes.
  • Modify any source code during UAT.

Pre-requisites

  • Git submodules initialized: git submodule update --init --recursive
  • GitHub UAT: Authentication is automatic for coding agents (uses GH_UAT_TOKEN). For local dev: gh auth login.
  • Azure DevOps UAT: Authentication is automatic for coding agents (uses AZDO_UAT_TOKEN → AZURE_DEVOPS_EXT_PAT). For local dev: set AZURE_DEVOPS_EXT_PAT.
bash
# Minimum: one feature-specific report with test instructions
scripts/uat-run.sh \
  --report artifacts/<feature-specific-report>.md \
  --instructions "In azurerm_key_vault_secret.audit_policy, verify key_vault_id displays as 'Key Vault \`kv-name\` in resource group \`rg-name\`' instead of full /subscriptions/ path"

# Multiple feature-specific reports (all with instructions):
scripts/uat-run.sh \
  --report artifacts/feature-a.md \
  --instructions "Verify feature A renders correctly" \
  --report artifacts/feature-b.md \
  --instructions "Verify feature B renders correctly"

# GitHub only:
scripts/uat-run.sh \
  --report artifacts/<feature>.md \
  --instructions "..." \
  --platform github

# Create PRs without polling (for manual review workflow):
scripts/uat-run.sh \
  --report artifacts/<feature>.md \
  --instructions "..." \
  --create-only
# After the Maintainer records the gate decision, the Release Manager cleans up:
scripts/uat-run.sh --cleanup-last
Show full SKILL.md (205 more words)Show less

What the Script Does

  1. Validates that all provided artifacts are up-to-date (built from current branch code)

  2. Auto-configures GitHub/AzDO authentication for coding agent environments

  3. Creates a unique UAT branch in the UAT repos

  4. Creates UAT PR(s) on GitHub and/or Azure DevOps

  5. Posts each feature report as a PR comment with the format:

    ## Test Instructions
<instructions you provided>

## Report
<artifact content>

  6. Automatically appends artifacts/comprehensive-demo-simple-diff.md (GitHub) and artifacts/comprehensive-demo.md (AzDO) as the final regression test comment

  7. Polls for approval (unless --create-only)

  8. Cleans up PRs and branches on approval

0. Rebase on Latest Main

Before running UAT, ensure your branch is up to date to avoid testing against stale base changes. Use the git-rebase-main skill.

1. Generate Fresh Artifacts (if needed)

bash
# If script fails with "Artifact is outdated":
scripts/generate-demo-artifacts.sh

# For feature-specific artifacts:
dotnet run --project src/Oocx.TfPlan2Md/Oocx.TfPlan2Md.csproj -- \
  [your args] --output artifacts/<feature-specific>.md

Troubleshooting

IssueSolution
"Artifact is outdated"Run scripts/generate-demo-artifacts.sh to regenerate all demo artifacts
"At least one --report/--instructions pair is required"Provide --report <file> --instructions "<text>"
"Each --report must have a corresponding --instructions"Check that --report and --instructions are properly paired
"GH_UAT_TOKEN is not set"Export it in your shell: export GH_UAT_TOKEN=...
"AZDO_UAT_TOKEN not set"Export it in your shell: export AZDO_UAT_TOKEN=...
Submodule not initializedRun git submodule update --init --recursive
"Branch already exists"Old UAT branch still present; run scripts/uat-run.sh --cleanup-last

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

Files

Just SKILL.md in .agents/skills/run-uat of oocx/tfplan2md.

Open the folder on GitHubat commit 88d5240

Compare with similar skills

Run Uat 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.

Run Uat compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Run Uat this skilloocx/tfplan2md174—~1.2kAutomated safety check: PassMIT
Azure Pipelines Log Downloaderansible/ansible71k—~825Automated safety check: PassGPL-3.0
ONNX Runtime CI Managementmicrosoft/onnxruntime22k—~4.1kAutomated safety check: PassMIT
Triageflowershow/flowershow1.1k—~1.9kAutomated safety check: PassAGPL-3.0
Migrate To TeamcityJetBrains/teamcity-cli125—~1.3kAutomated safety check: PassApache-2.0
Sdaf Orientation And SurfaceAzure/sap-automation145—~1.6kAutomated safety check: PassMIT

Similar skills

  • Azure Pipelines Log Downloader

    ansible/ansible

    Downloads Azure Pipelines CI logs for an Ansible pull request or build so the agent can analyze test failures, after asking you first.

    71k GitHub stars~825 tokensUpdated yesterday
    DevOps & CloudAuto-check passed

  • ONNX Runtime CI Management

    microsoft/onnxruntime

    Official

    Triggers, re-runs and unblocks the CI checks on an ONNX Runtime pull request, after diagnosing whether a failure is transient or needs a code change.

    22k GitHub stars~4.1k tokensUpdated today
    DevOps & CloudAuto-check passed

  • Triage

    flowershow/flowershow

    Automatically triage a newly opened GitHub issue — categorise it, verify the claim, and apply the right category and state so a maintainer or agent can pick it up.

    1.1k GitHub stars~1.9k tokensUpdated yesterday
    DevOps & CloudAuto-check passed

  • Migrate To Teamcity

    JetBrains/teamcity-cli

    Official

    Migrating CI/CD pipelines to TeamCity. An agent skill from JetBrains/teamcity-cli.

    125 GitHub stars~1.3k tokensUpdated yesterday
    DevOps & CloudAuto-check passed

  • Sdaf Orientation And Surface

    Azure/sap-automation

    Official

    Orient a newcomer to the SAP Deployment Automation Framework (SDAF): explain the spine (control plane → workload zone → SAP system → software → install → operate/remove), summarise the three…

    145 GitHub stars~1.6k tokensUpdated yesterday
    DevOps & CloudAuto-check passed

  • Dotnet Devops

    novotnyllc/dotnet-artisan

    Configures .NET CI/CD pipelines (GitHub Actions with setup-dotnet, NuGet cache, reusable workflows; Azure DevOps with DotNetCoreCLI, templates, multi-stage), containerization (multi-stage…

    233 GitHub stars~1.1k tokensUpdated today
    DevOps & CloudAuto-check passed

More from oocx/tfplan2md

All 28 skills in this repo

  • Create Agent Skill

    oocx/tfplan2md

    Create a new Agent Skill following project standards and templates.

    174 GitHub stars~1.5k tokensUpdated today
    Auto-check passed

  • Detect Diagram Crossings

    oocx/tfplan2md

    Detect and analyze edge crossings and overlaps in SVG workflow diagrams using geometric intersection algorithms and visual analysis.

    174 GitHub stars~4.3k tokensUpdated today
    Auto-check passed

  • Generate Release Screenshots

    oocx/tfplan2md

    Generate PNG screenshots for release notes using the repository's HtmlRenderer and ScreenshotGenerator tools.

    174 GitHub stars~3.7k tokensUpdated today
    Auto-check passed

  • Git Rebase Main

    oocx/tfplan2md

    Safely rebase the current feature branch on top of the latest origin/main.

    174 GitHub stars~456 tokensUpdated today
    Auto-check passed

  • Next Issue Number

    oocx/tfplan2md

    Determine the next available issue number across all change types (feature, fix, workflow, website) by checking both local docs and remote branches, then reserve it by pushing an empty branch.

    174 GitHub stars~1.5k tokensUpdated today
    Auto-check passed

  • Update Workflow Diagram

    oocx/tfplan2md

    Convert the mermaid diagram in docs/workflow.md to a blueprint-styled SVG for the website.

    174 GitHub stars~1.3k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Run Uat

What does Run Uat do?

Run User Acceptance Testing by creating a PR with rendered markdown on GitHub or Azure DevOps. Run Uat is an agent skill from oocx/tfplan2md. Run User Acceptance Testing by creating a PR with rendered markdown on GitHub or Azure DevOps.

When should I use Run Uat?

Run Uat fits situations like: validating markdown rendering in real platforms; tasks that involve Markdown.

How do I install Run Uat in Claude Code?

Run `npx skills add oocx/tfplan2md --skill run-uat -a claude-code`. Or copy the skill folder (.agents/skills/run-uat in oocx/tfplan2md) into .claude/skills/run-uat in your project. Claude Code loads it when a task matches its description.

How do I install Run Uat in Codex?

Run `npx skills add oocx/tfplan2md --skill run-uat -a codex`. Or copy the skill folder (.agents/skills/run-uat in oocx/tfplan2md) into .agents/skills/run-uat in your project. Codex loads it when a task matches its description.

Can I use Run Uat 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 oocx/tfplan2md --skill run-uat -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/run-uat, .gemini/skills/run-uat, .github/skills/run-uat and .opencode/skills/run-uat in your project.

What does Run Uat need to run?

Going by SKILL.md and its folder, Run Uat needs the command-line tools its instructions call (git, dotnet and gh) and credentials named GH_UAT_TOKEN and AZDO_UAT_TOKEN. Our summary lists: A credential in GH_UAT_TOKEN; A credential in AZDO_UAT_TOKEN. Compatibility (from SKILL.md): Requires git. GitHub UAT uses repo scripts which require GitHub CLI (gh) authenticated. Azure DevOps UAT requires Azure CLI (az) + azure-devops extension. Network access required..

Does Run Uat access the network?

SKILL.md contains no URLs. Its commands use git and gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Run Uat 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 Run Uat use?

Run Uat 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 Run Uat use?

About 1.2k tokens (SKILL.md is roughly 4.9k 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 Run Uat?

Skills that share tags, products or a category with Run Uat: Azure Pipelines Log Downloader (ansible/ansible, 71k stars), ONNX Runtime CI Management (microsoft/onnxruntime, 22k stars), Triage (flowershow/flowershow, 1.1k stars) and Migrate To Teamcity (JetBrains/teamcity-cli, 125 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Run Uat?

oocx (a GitHub user) maintains it in oocx/tfplan2md, which has 174 GitHub stars. The repository holds 28 skills in this directory. The repository was last updated on October 7, 2026.

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