Format file references as markdown links

SkillFiles & storage

When referencing files, format them as markdown links with line numbers using GitHub-style #L syntax.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Format file references as markdown links skill

What this skill tells your AI

The instructions your AI receives, as published by xenodium/emacs-skills in skills/file-links/SKILL.md and read by ahel’s review.

When referencing files in your output, always format them as markdown links. Use the GitHub-style #L fragment for line numbers.

Format

With a line number:

[filename.el:42](relative/path/to/filename.el#L42)

With a line range:

[filename.el:42-50](relative/path/to/filename.el#L42-L50)

Without a line number:

[filename.el](relative/path/to/filename.el)

Important

  • The link text uses : for line numbers (e.g., filename.el:42).
  • The URL uses #L for line numbers (e.g., filename.el#L42).
  • For ranges, the link text uses - (e.g., filename.el:42-50) and the URL uses -L (e.g., filename.el#L42-L50).
  • The range must appear in both the link text and the URL.

Do NOT do this:

[filename.el#L42-L50](filename.el#L42)

Rules

  • Use paths relative to the project root.
  • Include line numbers when they are relevant (e.g., error locations, function definitions, modified lines).
  • Use line ranges when referring to a block of code.
  • The link text should be the filename (or relative path if needed for clarity) followed by the line number.

Signals

GitHub stars
135
Forks
17
Last commit
Jul 2026
Advanced
Catalog kind
skill
Gateway key
file-links
Source
github.com/xenodium/emacs-skills