link-polisher

Rewrite raw Figma and GitHub URLs in Markdown files into descriptive links.

1|Updated May 21, 2020
One-click install
npx skills add https://github.com/ahandsel/debugging_log --skill link-polisher
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: link-polisher
Source: https://github.com/ahandsel/debugging_log/tree/main/skills/link-polisher
Command: npx skills add https://github.com/ahandsel/debugging_log --skill link-polisher

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the clutter of raw, unformatted URLs in your Markdown files by automatically replacing them with descriptive, human-readable labels.

Core Features & Use Cases

  • Smart Resolution: Automatically fetches titles for Figma files and GitHub issues or pull requests to create meaningful link text.
  • Context Preservation: Maintains original URL parameters, fragments, and tracking data while updating only the visible label.
  • Use Case: When you paste a bare GitHub issue URL into your project notes, this Skill detects it and converts it into a clean link like Fix login bug #123.

Quick Start

Use the link-polisher skill to scan the current file and rewrite all raw Figma and GitHub links with their proper titles.

Frequently Asked Questions about link-polisher

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically convert raw GitHub URLs to readable links in Markdown?

To convert raw GitHub URLs to readable links in Markdown, you can use an automation tool to fetch issue or pull request titles and rewrite the URLs as descriptive links. This improves documentation readability by replacing cluttered URLs with human-readable labels.

Can I fetch Figma file titles to format links in project notes?

Yes, you can fetch Figma file titles to format links in project notes by connecting to the Figma MCP server. The tool resolves canonical titles for design files and uses them as the display text for the links, ensuring your notes are clear and navigable.

Do I need the GitHub CLI to resolve issue titles for Markdown links?

Yes, you need the GitHub CLI installed and accessible to resolve issue titles for Markdown links. The tool relies on the GitHub CLI to fetch the canonical metadata required to generate the descriptive text for issues and pull requests.

What is the best way to format bare URLs in documentation without losing tracking parameters?

The best way to format bare URLs in documentation without losing tracking parameters is to use a link formatting tool that preserves original URL parameters and fragments. This updates only the visible label while maintaining the underlying URL data.

Does link formatting work for both GitHub pull requests and Figma design files?

Yes, link formatting works for both GitHub pull requests and Figma design files. The tool automatically detects URLs from both platforms, fetches their respective metadata, and generates clean links with the appropriate titles for issues, PRs, and design files.

Why do raw URLs in Markdown files reduce documentation readability?

Raw URLs in Markdown files reduce documentation readability because they clutter the text with long, unstructured strings. Converting them into descriptive links by fetching their actual titles improves navigation and makes the context immediately clear to readers.