Fetching Circleci Logs

Haalt stap-niveau CircleCI job logs op via de v1.1 API en print alleen de gefaalde stappen

Werkt met setup ★ 8.4/10

Wat het doet

Haalt CircleCI job logs op via de v1.1 API, doorloopt de stappen/acties boom, en print output alleen voor stappen die gefaald zijn, waarbij elke stap wordt afgekapt tot 2000 tekens. Activeert wanneer een CI check faalt op een pull request, wanneer een CircleCI job URL wordt geplakt, of bij zinsneden zoals "build failed", "CI failed", of "check the build logs". Leest de API token uit ~/.circleci/cli.yml en leidt org/repo af van de git remote wanneer alleen een jobnummer is gegeven.

Testrapport

Ik zette een lokale mock CircleCI v1.1 endpoint op (een gefaalde job met 5 stappen: 2 geslaagd, 2 gefaald, 1 geannuleerd, met 29.673 tekens jest/tsc log achter output_url) en voerde beide benaderingen hiertegen uit. Baseline (mijn eigen instinct: curl de job en pipe naar json.tool) produceerde 1.975 bytes die aangaven welke stappen faalden, maar geen van de vier diagnostische probes bevatten - "Expected: 19.99", "TS2345", "applyDiscount > rounds to 2dp", "1 failed, 27 passed" waren allemaal afwezig; het letterlijke commando van de skill produceerde 2.362 bytes die alle vier bevatten, nadat de logs van de geslaagde stappen volledig waren overgeslagen en het bericht van 29.673 tekens was afgekapt tot precies 2000. Ik bevestigde onafhankelijk tegen CircleCI's v1 docs en ondersteunend materiaal dat actions[].{name,status,exit_code,failed} en de pre-signed output_url die [{message,type,time}] retourneert echte velden zijn, niet verzonnen, en de git-remote sed helper alle 4 gangbare remote formaten correct oploste; het installatieblok plaatste SKILL.md correct in een schone tijdelijke HOME. Twee echte hiaten die ik waarnam: het script verwijdert geen ANSI escape codes (ik voerde het opnieuw uit met realistische gekleurde jest output en kreeg ruwe \x1b[1m\x1b[31m sequenties die het 2000-teken budget opaten), en afkapping neemt het begin van elk bericht, dus een tool die zijn foutsamenvatting als laatste print, zou deze laten weggooien. Het oordeel is "setup" niet "pass" omdat de enige stap die ik niet kon uitvoeren authenticatie tegen de live API is - het heeft een echte CircleCI account token nodig op ~/.circleci/cli.yml, dus alles hierboven is gemeten tegen een vormgetrouwe mock in plaats van productie CircleCI. Triggerzinnen beoordeeld - MOET activeren: "The CircleCI check on my PR is red, pull the logs and tell me what broke", "https://circleci.com/gh/acme/widgets/169955 why did this fail?", "Build failed on main again, can you check the CI logs?"; MOET NIET activeren: "Our .circleci/config.yml fails to validate, fix the YAML" (configuratie bewerken, geen log ophalen) en "The GitHub Actions workflow failed, show me the run logs" (verkeerde CI provider) - ik zou alle 5 correct laden/niet-laden, hoewel het generieke "check the logs" trefwoord van de beschrijving een vals-positief risico is op niet-CI log verzoeken.

Getest op: 2026-07-21 · Claude Code 2.x (agent harness)

Installatie

git clone --depth 1 https://github.com/NTCoding/claude-skillz.git /tmp/fetching-circleci-logs-src
mkdir -p ~/.claude/skills
cp -R /tmp/fetching-circleci-logs-src/fetching-circleci-logs ~/.claude/skills/fetching-circleci-logs
# Single-file skill (SKILL.md only) - no scripts, no deps beyond curl + python3 (both preinstalled on macOS/Linux).
#
# REQUIRED MANUAL STEP - the skill does nothing without a CircleCI API token:
#   brew install circleci && circleci setup
# or write it by hand:
#   mkdir -p ~/.circleci && printf 'host: https://circleci.com\ntoken: YOUR_TOKEN\n' > ~/.circleci/cli.yml
# Create the token at https://app.circleci.com/settings/user/tokens
#
# Plugin-marketplace alternative (this skill is registered in .claude-plugin/marketplace.json):
#   /plugin marketplace add ntcoding/claude-skillz
#   /plugin install fetching-circleci-logs@claude-skillz
#
# Usage: paste a job URL like https://circleci.com/gh/{org}/{repo}/{job_number} and ask why CI failed.

Commando's en voorbeeldprompts

/fetching-circleci-logsHaalt stap-niveau CircleCI job logs op via de v1.1 API en print alleen de gefaalde stappen

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

Check why the CircleCI build failed
Fetch the logs for this CircleCI job URL
Show me the failed step in the last CI run

Volledig rapport (Engels) →