configs/ai/skills/web-to-markdown/SKILL.md

name, description

name	description
web-to-markdown	Use when the user asks to grab, download, or copy an article from a website (e.g. 'grab me a copy of <url>' or 'convert <url> to markdown'). This skill uses the web-to-markdown utility to convert articles to markdown and download inline images.

Web-to-Markdown Skill

This skill allows the agent to download an HTML page, extract its main article content, convert it to Markdown, and download all inline images using the local web-to-markdown utility.

Prerequisites

• The utility is located at /srv/dev/web-to-markdown/web-to-markdown.
• Always check that this executable exists before proceeding.

Workflow

When the user asks to download or grab a copy of a website article, follow these steps:

1. Ask for configuration: Before running the script, ask the user:

   • Destination: Where should the article be saved? (Suggest the current directory or a logical default like docs/ or notes/).
   • Title: What should the folder/article title be? (Suggest a simplified version of the URL slug or ask if they want the tool to extract the default title by omitting the title flag).

2. Execute the Utility: Once you have the configuration, use the run_shell_command tool to execute the web-to-markdown utility.

   Command Syntax: /srv/dev/web-to-markdown/web-to-markdown -out "<destination_path>" -title "<custom_title>" "<url>" Note: Omit -title "<custom_title>" if the user wants the tool to use the default parsed title.

3. Verify and Confirm:

   • Review the output of the shell command to ensure it was successful.
   • List the target directory to verify the index.md and any downloaded images exist.
   • Inform the user of the successful download and the exact path where the new markdown file is located.