---
name: web-to-markdown
description: "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.

