# Download CI Artifacts

> Download artifacts from a CI run's GCS bucket to local disk.

- Skill: `kubernetes/download-ci-artifacts` (Agent Skill)
- Install (CLI): `npx skillmds@latest add kubernetes/download-ci-artifacts`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kubernetes/download-ci-artifacts/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: kubernetes (https://skillmd.com/u/kubernetes)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kubernetes/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://<bucket>`).
* **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://<bucket>` 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.