tooldeck

# ToolDeck - Personal Service/Tool Database

## Trigger
Use this skill when:
1. User shares a URL and explicitly asks to save it
2. User asks to "save" or "remember" a service or tool they provided
3. User asks "what tools do I have for X"
4. User explicitly requests tool suggestions for a project

> **Privacy first:** Never scrape, save, or monitor URLs without explicit user request. The skill is entirely passive — it only acts when the user intentionally asks it to.

## What It Does

User provides a URL with intent to save → scrape → extract info → categorize → confirm → save to database

## Workflow

### 1. Saving a Tool (User-Initiated Only)

**Step 1: Confirm intent**
- Only proceed if user explicitly asked to save a URL
- Never auto-save from casual browsing or project context

**Step 2: Scrape the URL**
- Use `web_fetch` to get page info
- Extract: title, description, pricing, features, logo
- **Respect robots.txt** — do not scrape pages that disallow it
- **Skip authenticated/private pages** — do not attempt to scrape pages behind login walls, paywalls, or CAPTCHAs

**Step 3: Auto-categorize**
- Analyze content to detect category:
  - **AI/ML** - AI services, LLMs, machine learning
  - **Development** - Coding tools, APIs, frameworks
  - **Productivity** - Task management, notes, workflow
  - **Marketing** - SEO, social media, ads
  - **Design** - Graphics, UI/UX, video
  - **Finance** - Billing, accounting, payments
  - **Communication** - Messaging, email, calls
  - **Data** - Analytics, databases, visualization
  - **Other** - Anything else

**Step 4: Find social media**
- Search for LinkedIn, Facebook, Instagram, Twitter
- Use `web_search` with tool name + "social media"

**Step 5: Auto-generate tags**
- Extract keywords from description
- Common tags: free, paid, api, no-code, ai, etc.

**Step 6: Confirm and save**
- Present the extracted info to the user
- Only save after user confirms
- Confirm: "Saved: [title] ([category])"

### 2. Retrieving Tools

- By category: "Show me all AI tools"
- By search: "Find something for PDF"
- Full list: "List all my saved tools"

### 3. Tool Suggestions (Opt-In Only)

- Only suggest tools when the user explicitly asks for project help
- Do not proactively monitor or inject suggestions during normal chat

## Content Boundaries

**Never scrape:**
- Pages behind login, paywall, or authentication
- Pages blocked by robots.txt
- Private/intranet URLs
- URLs containing personal data (icloud, google drive shared links, etc.)

**Sanitization:**
- Do not store OAuth tokens, API keys, or session IDs if present in URLs
- Strip tracking parameters (utm_*, fbclid, etc.) from URLs before saving

## Database Location

`/workspace/skills/tooldeck/references/database.json`

## Format

```json
{
  "tools": [
    {
      "url": "https://example.com",
      "title": "Tool Name",
      "description": "What it does",
      "category": "Development",
      "tags": ["python", "api", "free"],
      "use_case": "For building APIs",
      "notes": "Good alternatives to X",
      "saved_date": "2026-04-04",
      "price": "Free / $X/mo",
      "social_media": {
        "linkedin": "...",
        "facebook": "...",
        "instagram": "..."
      },
      "contact": {
        "email": "...",
        "location": "..."
      }
    }
  ]
}
```