# Download CI Artifacts > Download artifacts from a CI run's GCS bucket to local disk. Use when this capability is needed. - Skill: `tomevault-io/download-ci-artifacts` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/download-ci-artifacts` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/download-ci-artifacts/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: DevOps & Infra - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/download-ci-artifacts --- # Goal Download artifacts from a CI run's GCS bucket to a local directory safely, handling credential constraints. # Instructions ## 1. Parse URI * **DO** normalize the input URI: accept gcsweb URLs (`https://gcsweb.k8s.io/gcs/...`), raw `gs://` paths, or Prow job URLs (`https://prow.k8s.io/view/gs/...`). * **DO** convert gcsweb/Prow URLs to standard GCS paths by replacing `https://gcsweb.k8s.io/gcs/` or `https://prow.k8s.io/view/gs/` with `gs://`. ## 2. Create Local Directory * **DO** create a local directory using an identifier extracted from the URI (e.g., the Prow build ID) if no output directory is provided. ## 3. Download * **DO** check if the environment is already authorized for `gcloud storage` by running a fast, timed-out query first (e.g., `timeout 5s gcloud storage ls gs://`). * **DO** ask the user to authorize or refresh their credentials if the `gcloud storage` check fails or times out. Suggest that they run one of these commands in their local terminal: - `gcloud auth login` (to log in again) - `gcloud auth application-default login` (if Application Default Credentials are missing/outdated) - Or simply run a command like `gcloud storage ls gs://` in their own local terminal and touch their security key when prompted to refresh the cached session. * **DO** use `gcloud storage cp` to download the target files or patterns specified by the user (e.g., `etcd.log`, `*.json`, `junit.xml`). * **DO NOT** decide what to download. Download only what the user explicitly requests. ## 4. Report * **DO** list the files downloaded and their sizes in the summary report. --- > Source: [kubernetes/perf-tests](https://github.com/kubernetes/perf-tests) — distributed by [TomeVault](https://tomevault.io).