adding skills / agents / other to config

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

@@ -0,0 +1,34 @@
+---
+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.
+