diff --git a/SKILL.md b/SKILL.md
index ad842f0..d5ba372 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -283,7 +283,9 @@ Each pattern entry:
 - Why (the force that makes this the right choice)
 - When to use (the trigger condition — what situation calls for this)
 - When NOT to use (where the pattern breaks down)
-- Source (file path + line, or commit where it's demonstrated)
+- Source (hyperlinked to the commit or file on the forge, e.g.
+  `[src/io/io.go#L86](https://github.com/golang/go/blob/master/src/io/io.go#L86)`.
+  Use permalink format with commit SHA when possible for stability.)
 
 **`smells.md`** — anti-patterns found in the source:
 - What it looks like