claudesidian: Skill for Claude Code

download-attachment

Download files from URLs to attachments folder and organize them with descriptive names.

Usage

/download-attachment <url1> [url2] [url3...]

Examples

/download-attachment https://example.com/document.pdf
/download-attachment https://site.com/image.png https://site.com/report.pdf

Implementation

You are tasked with downloading files from URLs and organizing them in the Obsidian vault attachments folder.

Step 1: Parse and Validate URLs

Extract the URL(s) from the user's input. Handle multiple URLs if provided.

• Validate URL scheme: Only allow http:// or https:// URLs
• Reject invalid URLs: file://, ftp://, or malformed URLs
• Example validation:

if [[ ! "$url" =~ ^https?:// ]]; then
  echo "Error: Only HTTP/HTTPS URLs are allowed"
  exit 1
fi

Step 2: Download Files

For each URL:

# Sanitize filename to prevent path traversal
# Remove ../ and other dangerous characters
filename=$(basename "$url" | sed 's/[^a-zA-Z0-9._-]/_/g')

# Use wget or curl to download with timeout
wget --timeout=30 -O "05_Attachments/$filename" "$url"
# or
curl --max-time 30 -L "$url" -o "05_Attachments/$filename"

Step 3: Verify Downloads

Check that files were downloaded successfully:

ls -la "05_Attachments/"

Step 4: Organize Files

After downloading, run the organize-attachments command to rename files with descriptive names:

For PDFs:

• Extract text with pdftotext
• Analyze content for meaningful title

For Images:

• Use mcp__gemini-vision__analyze_image or mcp__gemini-vision__analyze_multiple
• Generate descriptive filename based on content

Step 5: Move to Organized

Move renamed files to 05_Attachments/Organized/ with descriptive names

Step 6: Update Index

Add entries to 05_Attachments/00_Index.md

Step 7: Commit Changes

git add -A
git commit -m "Download and organize attachments from URLs"
git push

Important Notes

1. File Naming:
   • Initial download: Use URL filename or generate from URL
   • After analysis: Rename with descriptive title