35 lines
1.8 KiB
Markdown
35 lines
1.8 KiB
Markdown
---
|
|
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.
|
|
|