ワンクリックでManusで任意のスキルを実行

始める

fix-internal-links

スター7

フォーク7

更新日2026年6月17日 20:50

Find and fix broken internal links in the docs site using linkchecker

インストール

Codex または Claude でインストールこの Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。

Manusで実行

ソース

giantswarm

giantswarm/docs

GitHub リポジトリを開く Creator のリポジトリを見る

ダウンロード

Manusで実行

Fix broken internal links

Find and fix all broken internal links in the docs site.

Steps

Fetch the latest release tag for the docs container image:

az acr repository show-tags \
  --name gsoci \
  --repository giantswarm/docs \
  --orderby time_desc \
  --output tsv | grep -E '^[0-9]+\.[0-9]+\.[0-9]+$' | head -1

Store the tag as the TAG environment variable.

Start the docs server:

docker run -d --rm --name server -p 8080:8080 -P gsoci.azurecr.io/giantswarm/docs:$TAG

Run linkchecker to find broken internal links:

docker run --rm --name linkchecker \
  -v $PWD:/workdir \
  -w /workdir \
  --link server:server \
  ghcr.io/linkchecker/linkchecker:latest \
  http://server:8080 \
  -t 4 \
  --no-status \
  --file-output text/linkcheck-report.txt \
  --ignore-url="^https://docs\.giantswarm\.io/.*" \
  --ignore-url="^http://server:8080/changes/.*"

Read linkcheck-report.txt. Each link report starts with the term URL and ends with a double line break.
Fix each broken link:
- Update permanent redirects (301) to point directly to the real target URL
- Investigate and fix 404 not found errors
Stop the server:
```
docker kill server
```
Report results to the user.

IMPORTANT: Always use the relref shortcode for internal links. When modifying an internal link that was not using relref, convert it to relref syntax.

このリポジトリの他の Skills

同じリポジトリ

publish-crd-reference

giantswarm/docs

Understand and maintain how the CRD reference pages under /reference/platform-api/crd/ are generated — register a new CRD source repo, make sure every published CRD has an example CR, and fix pages that render without an example

2026-07-037

classify-diataxis

giantswarm/docs

Classify documentation pages into their Diátaxis type and propose the diataxis_content_type frontmatter value, flagging pages that mix modes

2026-06-267

export-to-miro

giantswarm/docs

Create a box on a Miro board for every row in a CSV inventory of pages (e.g. the output of the export-csv skill) — each box shows the page title as a clickable link to its URL, with the navigation path as a subline

2026-06-267

export-csv

giantswarm/docs

Export a CSV inventory of all documentation pages (title, navigation path levels, and public URL) from the frontmatter of every Markdown file under src/content

2026-06-267

assess-readability

giantswarm/docs

Assess English readability of documentation pages (Flesch Reading Ease, Flesch-Kincaid grade, Gunning Fog, LIX), excluding generated content

2026-06-227

improve-style

giantswarm/docs

Apply style fixes and run Vale prose linting on modified or added pages

2026-06-227

name	fix-internal-links
description	Find and fix broken internal links in the docs site using linkchecker

Fix broken internal links

Find and fix all broken internal links in the docs site.

Steps

Fetch the latest release tag for the docs container image:

az acr repository show-tags \
  --name gsoci \
  --repository giantswarm/docs \
  --orderby time_desc \
  --output tsv | grep -E '^[0-9]+\.[0-9]+\.[0-9]+$' | head -1

Store the tag as the TAG environment variable.

Start the docs server:

docker run -d --rm --name server -p 8080:8080 -P gsoci.azurecr.io/giantswarm/docs:$TAG

Run linkchecker to find broken internal links:

docker run --rm --name linkchecker \
  -v $PWD:/workdir \
  -w /workdir \
  --link server:server \
  ghcr.io/linkchecker/linkchecker:latest \
  http://server:8080 \
  -t 4 \
  --no-status \
  --file-output text/linkcheck-report.txt \
  --ignore-url="^https://docs\.giantswarm\.io/.*" \
  --ignore-url="^http://server:8080/changes/.*"

Read linkcheck-report.txt. Each link report starts with the term URL and ends with a double line break.
Fix each broken link:
- Update permanent redirects (301) to point directly to the real target URL
- Investigate and fix 404 not found errors
Stop the server:
```
docker kill server
```
Report results to the user.

IMPORTANT: Always use the relref shortcode for internal links. When modifying an internal link that was not using relref, convert it to relref syntax.