fenix-skills/skills/file-links/SKILL.md

1.3 KiB

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

Format file references as markdown links

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.