無料GitHub で公開

add-github-permalinks

Add GitHub permalinks with fixed SHA/commit references to research documentation containing code snippets. Use when writing technical docs with code examples, creating investigation/research docs that reference source files, user asks to "add permalinks" or "add GitHub links", documenting code research findings with file:line references, or creating audit trails needing permanent code references. Triggers on "add github links", "add permalinks", "link to source", "make code references permanent".

t4ku/agent-skills

インストール方法を見る

含まれるファイル（1）

SKILL.md3.0 KB

SKILL.md（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Add GitHub Permalinks

Add permanent GitHub file URLs to research documentation so code references don't break when files change.

Workflow

1. Identify Repositories

Scan the document for code references to determine which repositories are involved:

# Common patterns to detect:
repos/{repo}/path/to/file.rb:123     → submodule repo
app/models/user.rb:45                → current repo
commit abc123 in org/repo            → external repo

2. Get SHA for Each Repository

# For submodule repos
cd repos/{repo} && git rev-parse HEAD

# For current repo
git rev-parse HEAD

# For historical commits - use the commit SHA directly

3. Add Permalinks to Code Blocks

Transform code block comments from local paths to GitHub permalinks:

Before:

# app/models/user.rb:45-50
def example_method
  # implementation
end

After:

# app/models/user.rb:45-50
# https://github.com/{org}/{repo}/blob/{SHA}/app/models/user.rb#L45-L50
def example_method
  # implementation
end

4. Update Reference Tables

Convert plain file paths to clickable markdown links:

Before:

File	Line	Content
`app/models/user.rb`	45	method definition

After:

File	Line	Content
`app/models/user.rb`	45	method definition

5. Add Reference SHAs Header

Add a reference section at the top of Technical Notes or similar sections:

> **Reference SHAs (Permalinks):**
> - **{repo}**: [`{short_sha}`](https://github.com/{org}/{repo}/tree/{SHA}) (YYYY-MM-DD)

Permalink Format

https://github.com/{org}/{repo}/blob/{SHA}/{path}#L{start}-L{end}

Component	Example	Notes
org	`myorg`	GitHub organization or username
repo	`myrepo`	Repository name
SHA	`c617ebdcda...`	Full or short (10+ chars) commit SHA
path	`app/models/user.rb`	File path from repo root
#L{n}	`#L45`	Single line anchor
#L{n}-L{m}	`#L45-L50`	Line range anchor

Checklist

Identify all repositories referenced in document
Get current HEAD SHA for each repo (or use historical commit SHA if specified)
Add permalink comment below file path comments in code blocks
Convert file paths in evidence/reference tables to clickable links
Add Reference SHAs section documenting which commits are used
Update document changelog noting permalink addition

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

ログインしてレビューを書く

同じリポジトリのスキル

概要と使いどころ

airbnb-adr-simulator

無料

Fetch Airbnb income estimate (ADR, occupancy, monthly revenue) for any area using the official Airbnb GraphQL API — the same data the Airbnb host simulator shows. Input: station/area name. Output: per-night rate, avg nights, monthly estimate for entire_home and private_room.

日本語の概要は準備中です。原文の説明を表示しています。