Watch an Elixir/Phoenix PR with an Amp Orb keep-alive lease until required non-deployment CI is green and review threads are resolved.

MITAuto-check passedAI & LLM Engineering

Install Phx Watch PR

skills CLI
$ npx skills add oliver-kriska/claude-elixir-phoenix --skill phx-watch-pr -a claude-code

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

GitHub CLI
$ gh skill install oliver-kriska/claude-elixir-phoenix phx-watch-pr --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/oliver-kriska/claude-elixir-phoenix.git skills-src && mkdir -p .claude/skills && cp -r skills-src/targets/amp/skills/phx-watch-pr .claude/skills/phx-watch-pr && 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
phx-watch-pr
GitHub stars
565
Token cost
~1k tokens
SKILL.md length
545 words
Files
2 (incl. references)
Skills in repo
109
Repo updated
First seen
Licence
MIT

At a glance

Watch an Elixir/Phoenix PR with an Amp Orb keep-alive lease until required non-deployment CI is green and review threads are resolved.

  • Works in 5 steps: Acquire one bounded keep-alive lease —… → Deployment is never readiness —… → Never merge or deploy — watching and… → …
  • Tasks that involve LLM observability
  • SKILL.md covers Iron Laws, Start, Event Handling and Status and Stop, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Phx Watch PR is an agent skill from oliver-kriska/claude-elixir-phoenix. Watch an Elixir/Phoenix PR with an Amp Orb keep-alive lease until required non-deployment CI is green and review threads are resolved.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/watcher-mechanics.md`).

It sits in AI & LLM Engineering, covering LLM observability and Deployment. It works with Elixir. The repository describes itself as: Claude Code plugin for Elixir/Phoenix/LiveView — 26 specialist agents, Iron Laws enforcement, and Tidewave MCP integration. Plan features with parallel research agents, execute… The licence is MIT.

When your agent uses it

  • Tasks that involve LLM observability
  • Tasks that involve Deployment

Example prompts

  • “/phx-watch-pr”

Workflow steps

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

  1. Acquire one bounded keep-alive lease — start the plugin lifecycle once,
  2. Deployment is never readiness — deployment, release, preview,
  3. Never merge or deploy — watching and --fix authorize neither action.
  4. fix uses the same worker thread — the plugin serializes one concise
  5. Every watch is bounded — timeout and every other terminal path release

What it can do on your machine

Read from SKILL.md and the folder at commit 9767a82. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

    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

Phx Watch PR loads about 1k tokens when it runs, and up to ~2.6k if it reads all its reference files. Until then it costs about 37 tokens; SKILL.md has 545 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~37
When it runs · the whole SKILL.md, loaded when a task matches
~1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.6k

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 oliver-kriska/claude-elixir-phoenix at commit 9767a82, republished under its MIT licence (© oliver-kriska). 545 words, ~1,028 tokens.

Download SKILL.mdSave it as .claude/skills/phx-watch-pr/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
phx-watch-pr
description
Watch an Elixir/Phoenix PR with an Amp Orb keep-alive lease until required non-deployment CI is green and review threads are resolved.

Watch PR — Amp-Native Lifecycle

Use the elixir_phoenix_watch_pr plugin tool. Do not launch gh pr checks --watch, gh run watch, a foreground sleep loop, or the copied Claude watcher script: none of those owns an Amp Orb keep-alive lease.

Iron Laws

  1. Acquire one bounded keep-alive lease — start the plugin lifecycle once, then let its durable state and dedupe handle polling and plugin reloads.
  2. Deployment is never readiness — deployment, release, preview, production, and prod checks are reported under excludedChecks; they are never counted as passing or failing required CI.
  3. Never merge or deploy — watching and --fix authorize neither action.
  4. --fix uses the same worker thread — the plugin serializes one concise event turn at a time and directs that turn to the installed phx-pr-review workflow for actionable review feedback or failed required CI. Validate the cause before editing.
  5. Every watch is bounded — timeout and every other terminal path release the lease. A timeout is incomplete, never success.

Start

Parse the PR number/URL and flags, then call:

text
elixir_phoenix_watch_pr {
  "action": "start",
  "pr": "<number-or-url>",
  "checksOnly": false,
  "fix": false
}

Map --checks-only and --fix to booleans. Map --max-hours, --quiet-minutes, and --poll-seconds to maxDurationHours, quietPeriodMinutes, and pollIntervalSeconds. Defaults are 2 hours maximum, 15 minutes quiet, and 60 seconds polling. Report the tool's initial snapshot and then stop taking turns; the plugin wakes this thread only for actionable failures or feedback and terminal outcomes.

Event Handling

  • Unchanged snapshots do not wake the model.
  • A changed head SHA resets readiness but does not itself wake the model.
  • Failed or cancelled required non-deployment CI wakes the model once per distinct actionable snapshot. Pending and passing progress keeps polling inference-silent.
  • Excluded deployment-like checks appear separately in explicit status and terminal summaries. Their transitions do not reset readiness or wake the model.
  • Any unresolved review thread keeps the lease active.
  • A head push, required-check transition, review, or comment resets the quiet clock. This includes a review with no unresolved thread or dedicated check, but routine non-actionable activity does not wake the model.
  • With --fix, unresolved feedback explicitly loads phx-pr-review; required CI failures include check names and links. Re-fetch threads or inspect logs, fix only valid branch-owned causes, verify, push the authorized PR branch update, reply, and resolve where appropriate. Do not blindly rerun shared CI.
  • Required CI must remain green with zero unresolved threads and no relevant activity for the full quiet period before success releases the lease. Never accept an early green snapshot as immediate readiness.
Show full SKILL.md (146 more words)Show less

Status and Stop

Use the same tool with "action": "status" or "action": "stop". Stop is idempotent and releases the lease; it does not delete durable history.

Post-Completion Boundary

The plugin registers an optional durable Amp webhook and stores its bearer URL in the owner-only credential file reported by the tool. If a repository administrator configures GitHub to send PR review/check events to that URL, a later event can wake the paused Orb and probe the authoritative PR state. Webhook events must identify the exact watched PR number or current watched head SHA; empty or unrelated repository events are ignored.

The plugin never changes GitHub webhook settings. Without that external setup, polling ends after the quiet period and a later human comment cannot wake a paused Orb. Say this explicitly; do not imply polling continues after lease release.

Reference

  • references/watcher-mechanics.md — lease, durability, filtering, webhook, and billing behavior

© oliver-kriska, 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 (references) in targets/amp/skills/phx-watch-pr of oliver-kriska/claude-elixir-phoenix.

  • SKILL.md
  • references/watcher-mechanics.md

Open the folder on GitHubat commit 9767a82

Compare with similar skills

Phx Watch PR 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.

Phx Watch PR compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Phx Watch PR this skilloliver-kriska/claude-elixir-phoenix565—~1kAutomated safety check: PassMIT
Sentry Elixir SDKgetsentry/sentry-for-ai268—~3.5kAutomated safety check: PassApache-2.0
Langfuse Previewslangfuse/langfuse36k—~2.8kAutomated safety check: NotesCustom licence
Elixir Expertpass-agent/loomkin1811 repos~796Automated safety check: PassMIT
Serviceradar Elixircarverauto/serviceradar921—~1.7kAutomated safety check: PassApache-2.0
Langsmith Deploymentsoba-labs/langchain-agent-skills107—~1.7kAutomated safety check: PassMIT

Similar skills

  • Sentry Elixir SDK

    getsentry/sentry-for-ai

    Official

    Full Sentry SDK setup for Elixir. An agent skill from getsentry/sentry-for-ai.

    268 GitHub stars~3.5k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Langfuse Previews

    langfuse/langfuse

    Use Langfuse's disposable per-PR previews at pr-N.preview.langfuse.com (synthetic data only).

    36k GitHub stars~2.8k tokensUpdated today
    AI & LLM EngineeringAuto-check: notes
  • Elixir Expert

    pass-agent/loomkin

    Expert in Elixir, Phoenix Framework, and OTP. An agent skill from pass-agent/loomkin.

    181 GitHub starsUsed in 1 repo~796 tokens
    AI & LLM EngineeringAuto-check passed
  • Serviceradar Elixir

    carverauto/serviceradar

    A skill your agent uses for ServiceRadar Elixir, Phoenix, LiveView, Ash/Ecto, migrations, external downloads, Hex dependencies, formatting, or Dialyzer work.

    921 GitHub stars~1.7k tokensUpdated yesterday
    DatabasesAuto-check passed
  • Langsmith Deployment

    soba-labs/langchain-agent-skills

    Deploy and operate production agent servers with LangSmith Deployment.

    107 GitHub stars~1.7k tokensUpdated 1 mo ago
    AI & LLM EngineeringAuto-check passed
  • Phoenix

    ericrisco/rsc-harness

    A skill your agent uses when building an Elixir web app with Phoenix — contexts, Ecto schemas, changesets and migrations, LiveView, channels and PubSub, the generators, and the boundary between…

    180 GitHub stars~2.9k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check: notes

More from oliver-kriska/claude-elixir-phoenix

All 109 skills in this repo
  • Codex Ab

    oliver-kriska/claude-elixir-phoenix

    Run an A/B codex review experiment — holistic codex review vs 3 focused dimension passes (security, ecto, liveview) on the branch diff, classify findings, report a panel-value verdict.

    565 GitHub stars~977 tokensUpdated 5 days ago
    Auto-check passed
  • Audit

    oliver-kriska/claude-elixir-phoenix

    Project health audit and health check — architecture, performance, tests, dependencies, code quality.

    565 GitHub stars~2k tokensUpdated 5 days ago
    Auto-check passed
  • Compound Docs

    oliver-kriska/claude-elixir-phoenix

    Searchable Elixir/Phoenix/Ecto solution documentation system with; Use when consulting past solutions…

    565 GitHub stars~528 tokensUpdated 5 days ago
    Auto-check passed
  • Compound Docs

    oliver-kriska/claude-elixir-phoenix

    Searchable Elixir/Phoenix/Ecto solution documentation system with YAML frontmatter.

    565 GitHub stars~547 tokensUpdated 5 days ago
    Auto-check passed
  • Deploy

    oliver-kriska/claude-elixir-phoenix

    Elixir/Phoenix deployment patterns — Dockerfile, fly.toml, runtime.exs, mix release, rel/ overlays.

    565 GitHub stars~1.1k tokensUpdated 5 days ago
    Auto-check passed
  • Deps Update

    oliver-kriska/claude-elixir-phoenix

    Bump outdated Hex deps — inventory, snapshot changelogs, update, fix breaks, split reviewable PRs (patches bundled, majors solo).

    565 GitHub stars~1.4k tokensUpdated 5 days ago
    Auto-check passed

Works with

Questions about Phx Watch PR

What does Phx Watch PR do?

Watch an Elixir/Phoenix PR with an Amp Orb keep-alive lease until required non-deployment CI is green and review threads are resolved. Phx Watch PR is an agent skill from oliver-kriska/claude-elixir-phoenix. Watch an Elixir/Phoenix PR with an Amp Orb keep-alive lease until required non-deployment CI is green and review threads are resolved.

When should I use Phx Watch PR?

Phx Watch PR fits situations like: tasks that involve LLM observability; tasks that involve Deployment.

How do I install Phx Watch PR in Claude Code?

Run `npx skills add oliver-kriska/claude-elixir-phoenix --skill phx-watch-pr -a claude-code`. Or copy the skill folder (targets/amp/skills/phx-watch-pr in oliver-kriska/claude-elixir-phoenix) into .claude/skills/phx-watch-pr in your project. Claude Code loads it when a task matches its description.

How do I install Phx Watch PR in Codex?

Run `npx skills add oliver-kriska/claude-elixir-phoenix --skill phx-watch-pr -a codex`. Or copy the skill folder (targets/amp/skills/phx-watch-pr in oliver-kriska/claude-elixir-phoenix) into .agents/skills/phx-watch-pr in your project. Codex loads it when a task matches its description.

Can I use Phx Watch PR 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 oliver-kriska/claude-elixir-phoenix --skill phx-watch-pr -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/phx-watch-pr, .gemini/skills/phx-watch-pr, .github/skills/phx-watch-pr and .opencode/skills/phx-watch-pr in your project.

What does Phx Watch PR need to run?

SKILL.md names no scripts, command-line tools or credentials: Phx Watch PR is instructions for the agent only.

Does Phx Watch PR access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Phx Watch PR 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 Phx Watch PR use?

Phx Watch PR 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 Phx Watch PR 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. Its references folder adds about 1.6k tokens, read only when the agent opens those files.

What are the alternatives to Phx Watch PR?

Skills that share tags, products or a category with Phx Watch PR: Sentry Elixir SDK (getsentry/sentry-for-ai, 268 stars), Langfuse Previews (langfuse/langfuse, 36k stars), Elixir Expert (pass-agent/loomkin, 181 stars) and Serviceradar Elixir (carverauto/serviceradar, 921 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Phx Watch PR?

oliver-kriska (a GitHub user) maintains it in oliver-kriska/claude-elixir-phoenix, which has 565 GitHub stars. The repository holds 109 skills in this directory. The repository was last updated on October 5, 2026.

Source: oliver-kriska/claude-elixir-phoenix on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.