dev-linkify-cc-resources

Link Claude Code skill names mentioned in a CodeGrid article (data/{series}/{n}.md) to the author's public claude-resources repo, pinned to the latest commit hash so links don't rot. Use when: (1) use

SKILL.md

GitHub

Linkify CodeGrid skill mentions

CodeGrid articles in the AI-agents series mention Claude Code skills by name (/commits, /pr-complete, …). This skill turns the first prose mention of each published skill into a link to the author's public collection, claude-resources, pinned to the latest commit hash.

Pinning to a hash (not main) is deliberate: the repo changes often, and a hash-based ref keeps the article's link pointing at the version that existed at writing time. The repo is introduced once in an earlier article (a [column] titled 「筆者のスキルコレクション」 in 9.md), so later articles just inline-link — no need to re-introduce the repo.

Workflow

Step 1 — Identify the target article

Use the article the user is editing (from conversation context) or the path they pass. It's a file like data/{series-slug}/{n}.md in the CodeGrid articles repo.

Step 2 — Run the scan

python3 $HOME/.claude/skills/dev-linkify-cc-resources/scripts/scan.py <article.md>

The script resolves the claude-resources repo ($HOME/repos/*/claude-resources), fetches and reads the latest origin/main hash, lists the published skills, and reports a LINK THESE block: the first prose mention of each skill that exists in the repo, with the ready-to-paste markdown. It already excludes mentions inside code blocks, mentions already linked, and names that aren't real published skills.

Pass --repo <path> if the repo lives somewhere other than $HOME/repos/*/claude-resources.

Step 3 — Apply the links

For each entry in LINK THESE, wrap the inline-code skill name in the suggested link, leaving the surrounding prose untouched:

…9回目の連載で紹介した`/commits`という…
→ …9回目の連載で紹介した[`/commits`](https://github.com/Takazudo/claude-resources/blob/<hash>/skills/commits/)という…

Edit the live article, not the scan output. After editing, the URL format is https://github.com/Takazudo/claude-resources/blob/<hash>/skills/<name>/ — keep /blob/ and the trailing slash (GitHub redirects directory /blob/ to /tree/).

What gets linked, and what doesn't

The scan's repo membership check enforces the editorial rule automatically:

  • Linked: skills present in claude-resources/skills/, at their first prose mention.

  • Not linked: names that are hypothetical examples in the prose (e.g. /fix-typo,

    /brighten-photo) or personal skills the author hasn't published (e.g. /price-research) — these simply aren't in the repo, so the scan won't surface them.

  • Skipped: mentions inside fenced code blocks, and any skill already linked elsewhere in

    the article (only the first prose mention is linked, for readability).

If the user disagrees with a specific call (e.g. wants a second mention linked too, or wants to skip re-linking a skill already linked in an earlier article), follow their preference — the scan is a starting point, not a hard rule.