google / google/skills

Eight cloud.google.com documentation links across 7 skills return 404

Open
#206 1 comment 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
20k
Forks
1.6k
Avg merge
3d 13h
Merged PRs (30d)
1

Description

A link check across all skill markdown files found 8 unique `cloud.google.com` documentation URLs that return HTTP 404 (verified twice, following redirects). These appear in the "references"/further-reading sections that agents and users are directed to. In each case a current working page exists — the docs have moved.

| File:line | Dead link (404) | Working replacement (200) |
| :--- | :--- | :--- |
| `skills/cloud/gke-platform-security/SKILL.md:195` | `https://cloud.google.com/kubernetes-engine/docs/how-to/secret-manager` | `https://cloud.google.com/secret-manager/docs/secret-manager-managed-csi-component` |
| `skills/cloud/gke-platform-security/SKILL.md:196` | `https://cloud.google.com/binary-authorization/docs/getting-started-gke` | `https://cloud.google.com/binary-authorization/docs/setting-up` |
| `skills/cloud/gke-platform-security/SKILL.md:198` | `https://cloud.google.com/kubernetes-engine/docs/concepts/sandbox` | `https://cloud.google.com/kubernetes-engine/docs/how-to/sandbox-pods` |
| `skills/cloud/gke-workload-security/SKILL.md:239` | `https://cloud.google.com/kubernetes-engine/docs/how-to/pod-security-standards` | `https://cloud.google.com/kubernetes-engine/docs/how-to/podsecurityadmission` |
| `skills/cloud/gke-workload-security/SKILL.md:240` | `https://cloud.google.com/kubernetes-engine/docs/how-to/secret-manager` | `https://cloud.google.com/secret-manager/docs/secret-manager-managed-csi-component` |
| `skills/cloud/gke-upgrades/SKILL.md:211` | `https://cloud.google.com/kubernetes-engine/docs/how-to/rollout-sequencing` | `https://cloud.google.com/kubernetes-engine/docs/concepts/about-rollout-sequencing` |
| `skills/cloud/google-cloud-global-frontend-configuration/SKILL.md:125` | `https://cloud.google.com/load-balancing/docs/overview` | `https://cloud.google.com/load-balancing/docs` |
| `skills/cloud/alloydb-basics/references/mcp-usage.md:25` | `https://cloud.google.com/alloydb/docs/reference/` | `https://cloud.google.com/alloydb/docs/reference/rest` |
| `skills/cloud/bigtable-basics/SKILL.md:115` | `https://cloud.google.com/bigtable/docs/reference/sql` | `https://cloud.google.com/bigtable/docs/googlesql-overview` |

The suggested replacements are pages verified to return 200 today that cover the same topic — the responsible teams may know a more canonical target.

### Repro

```bash
for u in \
https://cloud.google.com/kubernetes-engine/docs/how-to/secret-manager \
https://cloud.google.com/binary-authorization/docs/getting-started-gke \
https://cloud.google.com/kubernetes-engine/docs/concepts/sandbox \
https://cloud.google.com/kubernetes-engine/docs/how-to/pod-security-standards \
https://cloud.google.com/kubernetes-engine/docs/how-to/rollout-sequencing \
https://cloud.google.com/load-balancing/docs/overview \
https://cloud.google.com/alloydb/docs/reference/ \
https://cloud.google.com/bigtable/docs/reference/sql; do
echo "$(curl -s -o /dev/null -w '%{http_code}' -L "$u") $u"
done
```

Related: #205 (broken *relative* links; this issue covers broken *external* links).

Contributor guide

Open the contributing guide

Research direction

Start with the listed lines in skills/cloud/gke-platform-security/SKILL.md, skills/cloud/gke-workload-security/SKILL.md, skills/cloud/gke-upgrades/SKILL.md, skills/cloud/google-cloud-global-frontend-configuration/SKILL.md, skills/cloud/alloydb-basics/references/mcp-usage.md, and skills/cloud/bigtable-basics/SKILL.md. Run the supplied curl reproduction, update each dead URL to its working replacement, then rerun the checks to confirm the referenced pages no longer return 404.

Written by the indexing model from the issue text.

Assessment

Tech stack
google-cloud
Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Active
Clarity
Clearly specified
Newbie friendliness
76/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.