// Fetches failed and errored test details from CircleCI job test URLs using the CircleCI API v2. Use when the user provides a CircleCI tests URL and asks for errors, failures, test results, or help fixing CI.
| name | fix-ci |
| description | Fetches failed and errored test details from CircleCI job test URLs using the CircleCI API v2. Use when the user provides a CircleCI tests URL and asks for errors, failures, test results, or help fixing CI. |
Use this skill to turn a CircleCI web tests URL like:
https://app.circle.example.com/pipelines/github/example-org/example-repo/19060/workflows/887679f9-1f30-43a6-a600-7292d29b3edc/jobs/215974/tests
into API calls to CircleCI v2 and summarize failing/erroring tests.
Make sure that the following environment variables are set in your environment. If not, raise an error.
CIRCLECI_TOKENCIRCLECI_API_BASEFor such test run [ -n "${CIRCLECI_TOKEN}" ] && echo "ENV OK" || echo "ERROR: MISSING ENV VAR"
From this skill directory:
python3 scripts/circleci_errors.py '<circleci-tests-url>'
Useful options:
python3 scripts/circleci_errors.py '<url>' --all # print all tests, not just failed/error tests
python3 scripts/circleci_errors.py '<url>' --json # emit normalized JSON
python3 scripts/circleci_errors.py '<url>' --base-url https://circle.example.com/api/v2
github/org/repo from app URLs, accepted by CircleCI Server; public cloud also accepts gh/org/repo for cloud URLs).GET /api/v2/project/{project-slug}/{job-number}/tests, following pagination.failure, failed, error, or errored, including class/name/file/message/source where available.If authentication fails, ask the user to provide/export a valid CircleCI token with permission to read the project/job.
Free-form ideation that investigates context, debugs code or agent behavior, explores implementation approaches or answers questions about a codebase. Use when the user explicitly mentions "hablemos".
Open Plan's file UI for a Plan-generated plan markdown file, ordinary markdown/HTML file, URL, or folder.
Open Plan on the latest rendered assistant message and use the returned annotations to revise that message or continue.
Open Plan's browser-based code review UI for the current worktree or a pull request URL, then act on the feedback that comes back.
Read Quip document contents from a quip.com URL using the Quip API. Use when the user provides a Quip document URL/id and asks to read, summarize, extract, or analyze the document.