Agent skill

Watch CI

by codervisor in codervisor/leanspec

Watch GitHub Actions CI status for the current commit until completion.

MITAuto-check: notesDevOps & Cloud

Install Watch CI

skills CLI
$ npx skills add codervisor/leanspec --skill watch-ci -a claude-code

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

GitHub CLI
$ gh skill install codervisor/leanspec watch-ci --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/codervisor/leanspec.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/watch-ci .claude/skills/watch-ci && 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
watch-ci
GitHub stars
296
Token cost
~724 tokens
SKILL.md length
162 words
Files
1
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

Watch GitHub Actions CI status for the current commit until completion.

  • Works in 4 steps: Get the current commit SHA and branch → Find the workflow run matching our exact… → Poll jobs until all complete (every 60s… → …
  • Tasks that involve CI/CD
  • SKILL.md covers Environment, Steps, CI Structure and Reporting
  • Calls curl, python3 and git; reaches api.github.com

What it does

Watch CI is an agent skill from codervisor/leanspec. Watch GitHub Actions CI status for the current commit until completion. Use after pushing changes to monitor build results.

Its SKILL.md is about 720 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in DevOps & Cloud, covering CI/CD. It works with GitHub Actions. The repository describes itself as: Lightweight, flexible Spec-Driven Development (SDD) for modern AI-powered development. The licence is MIT.

When your agent uses it

  • Tasks that involve CI/CD

Example prompts

  • “/watch-ci”

Requirements

  • Python 3
  • Pre-approved tools (allowed-tools): Bash

Workflow steps

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

  1. Get the current commit SHA and branch
  2. Find the workflow run matching our exact commit. The API returns runs newest-first; filter by head_sha. If the run hasn't appeared yet…
  3. Poll jobs until all complete (every 60s for Rust builds which take ~8-10 min)
  4. On failure, fetch the failed job logs to diagnose

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • python3
    • git

    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:

    • api.github.com

    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

Watch CI loads about 724 tokens when it runs. Until then it costs about 33 tokens; SKILL.md has 162 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash

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 codervisor/leanspec at commit ee122d6, republished under its MIT licence (© codervisor). 162 words, ~724 tokens.

Download SKILL.mdSave it as .claude/skills/watch-ci/SKILL.md (or your agent's skills folder).
name
watch-ci
description
Watch GitHub Actions CI status for the current commit until completion. Use after pushing changes to monitor build results.
allowed-tools
Bash
metadata.internal
true

Watch CI

Poll the GitHub Actions CI pipeline for the current HEAD commit until all jobs finish.

Environment

The gh CLI is not available in the Claude VM. Use the GitHub REST API via curl. The repo is codervisor/leanspec.

Steps

  1. Get the current commit SHA and branch:

    bash
    SHA=$(git rev-parse HEAD)
    BRANCH=$(git branch --show-current)
    echo "Watching CI for commit $SHA on branch $BRANCH"
  2. Find the workflow run matching our exact commit. The API returns runs newest-first; filter by head_sha. If the run hasn't appeared yet (GitHub can take a few seconds), retry up to 5 times with 10s waits:

    bash
    curl -sH "Accept: application/vnd.github+json" \
      "https://api.github.com/repos/codervisor/lean-spec/actions/runs?branch=$BRANCH&head_sha=$SHA&per_page=1" \
      | python3 -c "
    import json, sys
    data = json.load(sys.stdin)
    runs = data.get('workflow_runs', [])
    if not runs:
        print('NO_RUNS'); sys.exit()
    r = runs[0]
    print(f'RUN_ID={r[\"id\"]}')
    print(f'Status: {r[\"status\"]}  Conclusion: {r.get(\"conclusion\") or \"pending\"}  Commit: {r[\"head_sha\"][:8]}')"
  3. Poll jobs until all complete (every 60s for Rust builds which take ~8-10 min):

    bash
    curl -sH "Accept: application/vnd.github+json" \
      "https://api.github.com/repos/codervisor/lean-spec/actions/runs/$RUN_ID/jobs" \
      | python3 -c "
    import json, sys
    data = json.load(sys.stdin)
    for j in data.get('jobs', []):
        steps = [s for s in j.get('steps', []) if s['status'] == 'in_progress']
        step_info = f' -> {steps[0][\"name\"]}' if steps else ''
        print(f'{j[\"name\"]:40}  {j[\"status\"]:12}  {j.get(\"conclusion\") or \"\"}{step_info}')"
  4. On failure, fetch the failed job logs to diagnose:

    bash
    curl -sH "Accept: application/vnd.github+json" \
      "https://api.github.com/repos/codervisor/lean-spec/actions/runs/$RUN_ID/jobs" \
      | python3 -c "
    import json, sys
    data = json.load(sys.stdin)
    for j in data.get('jobs', []):
        if j.get('conclusion') == 'failure':
            print(f'FAILED: {j[\"name\"]} (id: {j[\"id\"]})')
            for s in j.get('steps', []):
                if s.get('conclusion') == 'failure':
                    print(f'  Step: {s[\"name\"]}')"

CI Structure

  • node (~2 min): pnpm install, build, typecheck, test
  • rust (~8-10 min, depends on node): cargo fmt, clippy, build, test, TS binding export

Reporting

Give the user a brief status update each poll cycle. On completion, summarize:

  • Overall result (success/failure)
  • Per-job results
  • If failed: which step failed and relevant error output

© codervisor, 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 .claude/skills/watch-ci of codervisor/leanspec.

Open the folder on GitHubat commit ee122d6

Compare with similar skills

Watch CI 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.

Watch CI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Watch CI this skillcodervisor/leanspec296—~724Automated safety check: NotesMIT
Analyze GitHub Action Logswithastro/astro63k1 repos~1.3kAutomated safety check: PassCustom licence
GitHub Actions Templatesbartstc/vite-ts-react-template12214 repos~1.9kAutomated safety check: PassMIT
Nushellccusage/ccusage19k—~938Automated safety check: PassCustom licence
Repo Hygiene Scan and FixQwenLM/qwen-code28k—~1.7kAutomated safety check: PassApache-2.0
Senior DevOps Toolkitmaslennikov-ig/claude-code-orchestrator-kit2606 repos~1.1kAutomated safety check: NotesCustom licence

Similar skills

  • Official

    Analyze recent GitHub Actions workflow runs to identify patterns, mistakes, and improvements.

    63k GitHub starsUsed in 1 repo~1.3k tokens
    DevOps & CloudAuto-check passed
  • GitHub Actions Templates

    bartstc/vite-ts-react-template

    Create production-ready GitHub Actions workflows for automated testing, building, and deploying applications.

    122 GitHub starsUsed in 14 repos~1.9k tokens
    DevOps & CloudAuto-check passed
  • Nushell

    ccusage/ccusage

    Guides ccusage Nushell scripts. An agent skill from ccusage/ccusage.

    19k GitHub stars~938 tokensUpdated today
    DevOps & CloudAuto-check passed
  • Scheduled CI skill that scans a repository for small, certain docs, test and code hygiene issues and fixes them on one branch with a commit per finding.

    28k GitHub stars~1.7k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Senior DevOps Toolkit

    maslennikov-ig/claude-code-orchestrator-kit

    Comprehensive DevOps skill for CI/CD, infrastructure automation, containerization, and cloud platforms (AWS, GCP, Azure). Includes pipeline setup…

    260 GitHub starsUsed in 6 repos~1.1k tokens
    DevOps & CloudAuto-check: notes
  • CI Failure Triage and Repair

    Chachamaru127/claude-code-harness

    Diagnoses failing CI pipelines and tests, deciding first whether the test or the implementation is at fault, and hands hard cases to a dedicated fixer subagent.

    3.2k GitHub starsUsed in 1 repo~1.1k tokens
    DevOps & CloudAuto-check: notes

More from codervisor/leanspec

  • Leanspec

    codervisor/leanspec

    The spec-coding methodology for AI-assisted development. An agent skill from codervisor/leanspec.

    296 GitHub stars~1.8k tokensUpdated 4 mo ago
    Auto-check passed
  • Leanspec Development

    codervisor/leanspec

    Development workflows, commands, publishing, CI/CD, changelog management, and contribution guidelines for LeanSpec.

    296 GitHub stars~2.5k tokensUpdated 4 mo ago
    Auto-check passed
  • Leanspec Dev Process

    codervisor/leanspec

    The end-to-end spec-issue-driven dev loop for lean-spec — spec → branch → implement → PR → merge → closure.

    296 GitHub stars~3.3k tokensUpdated 4 mo ago
    Auto-check passed
  • Leanspec PR Lifecycle

    codervisor/leanspec

    Manage a lean-spec PR after it's been pushed — spec-issue linking, CI triage, review-comment discipline, merge-conflict recovery on open PRs, webhook subscription, and CHANGELOG follow-through on…

    296 GitHub stars~3.3k tokensUpdated 4 mo ago
    Auto-check passed
  • Leanspec Pre Push

    codervisor/leanspec

    Run before pushing code to the lean-spec repo to catch what reviewers and CI will catch later, and confirm the branch has a linked spec issue in a valid state.

    296 GitHub stars~2.5k tokensUpdated 4 mo ago
    Auto-check passed

Works with

Categories

Questions about Watch CI

What does Watch CI do?

Watch GitHub Actions CI status for the current commit until completion. Watch CI is an agent skill from codervisor/leanspec. Watch GitHub Actions CI status for the current commit until completion.

When should I use Watch CI?

Watch CI fits situations like: tasks that involve CI/CD.

How do I install Watch CI in Claude Code?

Run `npx skills add codervisor/leanspec --skill watch-ci -a claude-code`. Or copy the skill folder (.claude/skills/watch-ci in codervisor/leanspec) into .claude/skills/watch-ci in your project. Claude Code loads it when a task matches its description.

How do I install Watch CI in Codex?

Run `npx skills add codervisor/leanspec --skill watch-ci -a codex`. Or copy the skill folder (.claude/skills/watch-ci in codervisor/leanspec) into .agents/skills/watch-ci in your project. Codex loads it when a task matches its description.

Can I use Watch CI 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 codervisor/leanspec --skill watch-ci -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/watch-ci, .gemini/skills/watch-ci, .github/skills/watch-ci and .opencode/skills/watch-ci in your project.

What does Watch CI need to run?

Going by SKILL.md and its folder, Watch CI needs the command-line tools its instructions call (curl, python3 and git). Our summary lists: Python 3. Its frontmatter pre-approves these tools: Bash.

Does Watch CI access the network?

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

Is Watch CI safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Watch CI use?

Watch CI 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 Watch CI use?

About 724 tokens (SKILL.md is roughly 2.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 Watch CI?

Skills that share tags, products or a category with Watch CI: Analyze GitHub Action Logs (withastro/astro, 63k stars), GitHub Actions Templates (bartstc/vite-ts-react-template, 122 stars), Nushell (ccusage/ccusage, 19k stars) and Repo Hygiene Scan and Fix (QwenLM/qwen-code, 28k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Watch CI?

codervisor (a GitHub organization) maintains it in codervisor/leanspec, which has 296 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on May 20, 2026.

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