[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75F19DTCM4XW4J3H1PQWFVC":3,"skill-same:01M75F19DTCM4XW4J3H1PQWFVC":65},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":42,"commitSha":43,"skillDirectory":44,"forksCount":45,"repositoryHtmlUrl":46,"repositoryHomepageUrl":6,"ownerHtmlUrl":47,"ownerBlogUrl":48,"ownerDescription":49,"updatedAt":50,"install":51,"resources":64},"01M75F19DTCM4XW4J3H1PQWFVC","clinkding",null,"Manage linkding bookmarks - save URLs, search, tag, organize, and retrieve your personal bookmark collection. Use when the user wants to save links, search bookmarks, manage tags, or organize their reading list.","javimosch\u002Fopen-claw-skills","javimosch","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F12900508?v=4","01M6D3F2AS6PV75ET9PZ1QGP8J","Javier Leandro Arancibia","01M75B8NCTAJG9WH5YNZH7C3D8",0,"MIT","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fdaveonkels\u002Fclinkding\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: clinkding\ndescription: Manage linkding bookmarks - save URLs, search, tag, organize, and retrieve your personal bookmark collection. Use when the user wants to save links, search bookmarks, manage tags, or organize their reading list.\nhomepage: https:\u002F\u002Fgithub.com\u002Fdaveonkels\u002Fclinkding\nmetadata: {\"clawdis\":{\"emoji\":\"🔖\",\"requires\":{\"bins\":[\"clinkding\"]},\"install\":[{\"id\":\"homebrew\",\"kind\":\"brew\",\"formula\":\"daveonkels\u002Ftap\u002Fclinkding\",\"bins\":[\"clinkding\"],\"label\":\"Install clinkding (Homebrew)\"},{\"id\":\"go\",\"kind\":\"go\",\"module\":\"github.com\u002Fdaveonkels\u002Fclinkding@latest\",\"bins\":[\"clinkding\"],\"label\":\"Install clinkding (Go)\"}]}}\n---\n\n# clinkding - Linkding Bookmark Manager CLI\n\nA modern Go-based CLI for managing bookmarks in [linkding](https:\u002F\u002Fgithub.com\u002Fsissbruecker\u002Flinkding), a self-hosted bookmark manager.\n\n## What This Does\n\n**Linkding** is a self-hosted bookmark manager (like Pocket, Instapaper). **clinkding** is the CLI that lets you manage your bookmarks from the terminal or via AI agents.\n\nThink of it as:\n- **Save for later** - Capture URLs you want to read\n- **Searchable library** - Full-text search across titles, descriptions, tags\n- **Organized collections** - Tag and bundle related bookmarks\n- **Personal archive** - Keep important links with notes and metadata\n\n## Quick Start\n\n### Initial Setup\n\n```bash\n# Interactive configuration\nclinkding config init\n\n# Or manually configure\nclinkding config set url https:\u002F\u002Fyour-linkding-instance.com\nclinkding config set token YOUR_API_TOKEN\n\n# Test connection\nclinkding config test\n```\n\n### Configuration File\n\nLocation: `~\u002F.config\u002Fclinkding\u002Fconfig.yaml`\n\n```yaml\nurl: https:\u002F\u002Flinkding.example.com\ntoken: your-api-token-here\n\ndefaults:\n  bookmark_limit: 100\n  output_format: auto\n```\n\n### Environment Variables\n\n```bash\nexport LINKDING_URL=\"https:\u002F\u002Flinkding.example.com\"\nexport LINKDING_TOKEN=\"your-api-token-here\"\n```\n\n## Core Commands\n\n### Bookmarks\n\n#### List & Search\n\n```bash\n# List recent bookmarks\nclinkding bookmarks list\n\n# Search by keyword\nclinkding bookmarks list --query \"golang tutorial\"\n\n# Filter by tag\nclinkding bookmarks list --query \"tag:programming\"\n\n# Recent bookmarks (last 7 days)\nclinkding bookmarks list --added-since \"7d\"\n\n# Unread bookmarks\nclinkding bookmarks list --query \"unread:yes\"\n\n# JSON output for scripting\nclinkding bookmarks list --json\n\n# Plain text (tab-separated)\nclinkding bookmarks list --plain\n```\n\n#### Create Bookmarks\n\n```bash\n# Simple bookmark\nclinkding bookmarks create https:\u002F\u002Fgo.dev\n\n# With metadata\nclinkding bookmarks create https:\u002F\u002Fgo.dev \\\n  --title \"Go Programming Language\" \\\n  --tags \"golang,programming,reference\" \\\n  --description \"Official Go website\" \\\n  --unread\n\n# Check if URL already exists before creating\nclinkding bookmarks check https:\u002F\u002Fgo.dev\n```\n\n#### Update Bookmarks\n\n```bash\n# Update title\nclinkding bookmarks update 42 --title \"New Title\"\n\n# Add tags\nclinkding bookmarks update 42 --add-tags \"important,work\"\n\n# Remove tags\nclinkding bookmarks update 42 --remove-tags \"old-tag\"\n\n# Mark as read\nclinkding bookmarks update 42 --read\n\n# Update description\nclinkding bookmarks update 42 --description \"Updated notes\"\n```\n\n#### Get Bookmark Details\n\n```bash\n# Full details\nclinkding bookmarks get 42\n\n# JSON output\nclinkding bookmarks get 42 --json\n```\n\n#### Archive & Delete\n\n```bash\n# Archive (hide from main list)\nclinkding bookmarks archive 42\n\n# Unarchive\nclinkding bookmarks unarchive 42\n\n# Delete permanently\nclinkding bookmarks delete 42\n```\n\n### Tags\n\n```bash\n# List all tags\nclinkding tags list\n\n# Create a tag\nclinkding tags create \"golang\"\n\n# Get tag details\nclinkding tags get 1\n\n# Plain text output\nclinkding tags list --plain\n```\n\n### Bundles\n\nBundles are collections of related bookmarks.\n\n```bash\n# List bundles\nclinkding bundles list\n\n# Create a bundle\nclinkding bundles create \"Go Resources\" \\\n  --description \"Everything related to Go programming\"\n\n# Update a bundle\nclinkding bundles update 1 --name \"Go Lang Resources\"\n\n# Get bundle details\nclinkding bundles get 1\n\n# Delete a bundle\nclinkding bundles delete 1\n```\n\n### Assets\n\nUpload and manage file attachments for bookmarks.\n\n```bash\n# List assets for a bookmark\nclinkding assets list 42\n\n# Upload a file\nclinkding assets upload 42 ~\u002FDocuments\u002Fscreenshot.png\n\n# Download an asset\nclinkding assets download 42 1 -o .\u002Fdownloaded-file.png\n\n# Delete an asset\nclinkding assets delete 42 1\n```\n\n### User Profile\n\n```bash\n# Get user profile info\nclinkding user profile\n```\n\n## Agent Usage Patterns\n\n### Save URL from Conversation\n\n```bash\n# User: \"Save this for later: https:\u002F\u002Fexample.com\"\nclinkding bookmarks create https:\u002F\u002Fexample.com \\\n  --title \"Article Title\" \\\n  --description \"Context from conversation\" \\\n  --tags \"topic,context\"\n```\n\n### Search Bookmarks\n\n```bash\n# User: \"Find my golang bookmarks\"\nclinkding bookmarks list --query \"golang\"\n\n# User: \"Show me unread programming articles\"\nclinkding bookmarks list --query \"tag:programming unread:yes\"\n\n# User: \"What did I save last week?\"\nclinkding bookmarks list --added-since \"7d\"\n```\n\n### Organize & Tag\n\n```bash\n# User: \"Tag bookmark 42 as important\"\nclinkding bookmarks update 42 --add-tags \"important\"\n\n# User: \"Create a bundle for my AI research links\"\nclinkding bundles create \"AI Research\" \\\n  --description \"Machine learning and AI papers\"\n```\n\n### Retrieve for Reading\n\n```bash\n# User: \"Give me something to read\"\nclinkding bookmarks list --query \"unread:yes\" --limit 5\n\n# User: \"Show me my golang tutorials\"\nclinkding bookmarks list --query \"tag:golang tag:tutorial\"\n```\n\n## Output Formats\n\n### Auto (Default)\nHuman-friendly tables and colors for terminal display.\n\n### JSON\n```bash\nclinkding bookmarks list --json\n```\nMachine-readable for scripting and agent parsing.\n\n### Plain Text\n```bash\nclinkding bookmarks list --plain\n```\nTab-separated values for pipe-friendly parsing.\n\n## Relative Date Filtering\n\nSupports human-friendly time ranges:\n\n```bash\n# Last 24 hours\nclinkding bookmarks list --added-since \"24h\"\n\n# Last 7 days\nclinkding bookmarks list --added-since \"7d\"\n\n# Last 6 months\nclinkding bookmarks list --modified-since \"180d\"\n```\n\n**Supported units:** `h` (hours), `d` (days), `y` (years)\n\n## Common Workflows\n\n### Morning Reading Routine\n\n```bash\n# Check unread bookmarks\nclinkding bookmarks list --query \"unread:yes\"\n\n# Get top 5 most recent\nclinkding bookmarks list --limit 5\n```\n\n### Save from Clipboard\n\n```bash\n# macOS\npbpaste | xargs -I {} clinkding bookmarks create {}\n\n# Linux\nxclip -o | xargs -I {} clinkding bookmarks create {}\n```\n\n### Batch Operations\n\n```bash\n# Tag multiple bookmarks\nfor id in 42 43 44; do\n  clinkding bookmarks update $id --add-tags \"important\"\ndone\n\n# Archive old unread bookmarks\nclinkding bookmarks list --query \"unread:yes\" --added-since \"30d\" --plain | \\\n  while read id _; do\n    clinkding bookmarks archive \"$id\"\n  done\n```\n\n### Backup Bookmarks\n\n```bash\n# Export all bookmarks as JSON\nclinkding bookmarks list --json > bookmarks-backup-$(date +%Y%m%d).json\n\n# Export specific tag\nclinkding bookmarks list --query \"tag:important\" --json > important.json\n```\n\n## Global Flags\n\nAvailable on all commands:\n\n| Flag | Description |\n|------|-------------|\n| `-c, --config \u003Cfile>` | Config file path |\n| `-u, --url \u003Curl>` | Linkding instance URL |\n| `-t, --token \u003Ctoken>` | API token |\n| `--json` | Output as JSON |\n| `--plain` | Output as plain text |\n| `--no-color` | Disable colors |\n| `-q, --quiet` | Minimal output |\n| `-v, --verbose` | Verbose output |\n\n## Exit Codes\n\n| Code | Meaning |\n|------|---------|\n| 0 | Success |\n| 1 | General error (API\u002Fnetwork) |\n| 2 | Invalid usage (bad flags\u002Fargs) |\n| 3 | Authentication error |\n| 4 | Not found |\n| 130 | Interrupted (Ctrl-C) |\n\n## Troubleshooting\n\n### Test Configuration\n\n```bash\n# Verify settings\nclinkding config show\n\n# Test connection\nclinkding config test\n```\n\n### Common Issues\n\n**Authentication Error:**\n- Verify API token in linkding web interface\n- Check URL includes protocol (`https:\u002F\u002F`)\n- Remove trailing slashes from URL\n\n**Command-Specific Help:**\n```bash\nclinkding bookmarks --help\nclinkding bookmarks create --help\n```\n\n## Links\n\n- **GitHub:** https:\u002F\u002Fgithub.com\u002Fdaveonkels\u002Fclinkding\n- **Linkding:** https:\u002F\u002Fgithub.com\u002Fsissbruecker\u002Flinkding\n- **Homebrew:** `brew install daveonkels\u002Ftap\u002Fclinkding`\n\n## Installation\n\n### Homebrew (macOS\u002FLinux)\n\n```bash\nbrew install daveonkels\u002Ftap\u002Fclinkding\n```\n\n### Go Install\n\n```bash\ngo install github.com\u002Fdaveonkels\u002Fclinkding@latest\n```\n\n### Binary Download\n\nDownload from [releases](https:\u002F\u002Fgithub.com\u002Fdaveonkels\u002Fclinkding\u002Freleases) for your platform.\n\n## Shell Completion\n\n```bash\n# Bash\nclinkding completion bash > \u002Fetc\u002Fbash_completion.d\u002Fclinkding\n\n# Zsh\nclinkding completion zsh > \"${fpath[1]}\u002F_clinkding\"\n\n# Fish\nclinkding completion fish > ~\u002F.config\u002Ffish\u002Fcompletions\u002Fclinkding.fish\n```\n\n---\n\n**Built by:** [@daveonkels](https:\u002F\u002Fgithub.com\u002Fdaveonkels)  \n**License:** MIT\n\n## Agent Workflows for Smart Bookmark Creation\n\n### Adding URLs with Automatic Metadata\n\nWhen a user says \"Add this to linkding\" or \"Save this URL\", follow this workflow:\n\n**1. Extract metadata from the URL**\n\nUse the `summarize` skill to get title and description:\n\n```bash\n# Get page metadata\nsummarize url https:\u002F\u002Fexample.com --format json\n```\n\nThis returns structured data with:\n- Title\n- Description\u002Fsummary\n- Main content\n\n**2. Infer appropriate tags from content**\n\nMap the content to **existing canonical tags only**. Do NOT create new tags.\n\nUse this canonical tag list (263 tags total):\n- **Tech:** webdev, design, programming, ai, cloud, devops, docker, linux, networking, security, privacy\n- **Content:** content, media, photography, video, audio, books, podcasting\n- **Business:** business, marketing, ecommerce, finance, career, productivity\n- **Home:** smart-home, home-assistant, esphome, iot, home-improvement\n- **Tools:** tools, cli, git, github, editor, reference, documentation\n- **Data:** data, analytics, mysql, nosql\n- **Communication:** communication, email, messaging, slack\n- **Education:** education, guide, howto, research, testing\n- **Locations:** texas, seattle, dallas (use sparingly)\n\n**Tag Selection Rules:**\n- Use 2-5 tags maximum\n- Choose the most specific applicable tags\n- If unsure, default to broader categories (e.g., `tools` over `generator`)\n- Check existing tags first: `clinkding tags list --plain | grep -i \u003Ckeyword>`\n- Never create tags like: `awesome`, `cool`, `interesting`, `resources`, `tips`\n\n**3. Create the bookmark with metadata**\n\n```bash\nclinkding bookmarks create \"https:\u002F\u002Fexample.com\" \\\n  --title \"Title from summarize\" \\\n  --description \"Summary from summarize (1-2 sentences)\" \\\n  --tags \"webdev,tools,reference\"\n```\n\n### Example Workflow\n\n**User:** \"Save this to linkding: https:\u002F\u002Fgithub.com\u002Fawesome\u002Fproject\"\n\n**Agent Actions:**\n\n```bash\n# 1. Check if already bookmarked\nclinkding bookmarks check https:\u002F\u002Fgithub.com\u002Fawesome\u002Fproject\n\n# 2. Get metadata (use summarize skill)\nsummarize url https:\u002F\u002Fgithub.com\u002Fawesome\u002Fproject --format json\n\n# 3. Analyze content and infer tags\n# From summary: \"A CLI tool for Docker container management\"\n# Canonical tags: docker, devops, cli, tools\n\n# 4. Create bookmark\nclinkding bookmarks create https:\u002F\u002Fgithub.com\u002Fawesome\u002Fproject \\\n  --title \"Awesome Project - Docker Container CLI\" \\\n  --description \"Command-line tool for managing Docker containers with enhanced features\" \\\n  --tags \"docker,devops,cli\"\n```\n\n### Tag Mapping Heuristics\n\nUse these rules to map content → canonical tags:\n\n| Content Type | Canonical Tags |\n|--------------|----------------|\n| Web development, HTML, CSS, JavaScript | `webdev`, `css`, `javascript` |\n| React, frameworks, frontend | `webdev`, `react` |\n| Design, UI\u002FUX, mockups | `design` |\n| Python, Go, Ruby code | `programming`, `python`\u002F`ruby` |\n| Docker, K8s, DevOps | `docker`, `devops`, `cloud` |\n| Home automation, ESP32, sensors | `smart-home`, `esphome`, `iot` |\n| AI, ML, LLMs | `ai`, `llm` |\n| Productivity tools, workflows | `productivity`, `tools` |\n| Finance, investing, crypto | `finance` |\n| Marketing, SEO, ads | `marketing` |\n| Shopping, deals, stores | `ecommerce` |\n| Tutorials, guides, docs | `guide`, `howto`, `documentation` |\n| Security, privacy, encryption | `security`, `privacy` |\n| Local (DFW\u002FSeattle) | `texas`, `seattle` |\n\n### Validation Before Creating\n\nAlways run these checks:\n\n```bash\n# 1. Does URL already exist?\nclinkding bookmarks check \u003Curl>\n\n# 2. Do the tags exist?\nclinkding tags list --plain | grep -iE \"^(tag1|tag2|tag3)$\"\n\n# 3. Are we using canonical tags?\n# Cross-reference against the 263 canonical tags\n# Never create new tags without explicit user request\n```\n\n### User Requests to Save Multiple Links\n\nIf user provides multiple URLs:\n\n```bash\n# Process each URL separately with metadata extraction\nfor url in url1 url2 url3; do\n  # Get metadata\n  # Infer tags\n  # Create bookmark\ndone\n```\n\n### Updating Existing Bookmarks\n\nIf user says \"Update that bookmark\" or \"Add tags to my last save\":\n\n```bash\n# Get most recent bookmark\nrecent_id=$(clinkding bookmarks list --limit 1 --plain | cut -f1)\n\n# Add tags (don't remove existing ones unless asked)\nclinkding bookmarks update $recent_id --add-tags \"new-tag\"\n\n# Update description\nclinkding bookmarks update $recent_id --description \"Updated notes\"\n```\n\n### Key Principles\n\n1. **Always fetch metadata** - Use `summarize` to get good titles\u002Fdescriptions\n2. **Use existing tags** - Never create new tags without checking canonical list\n3. **Be selective** - 2-5 tags max, choose the most specific applicable\n4. **Validate first** - Check for duplicates before creating\n5. **Provide context** - Include brief description explaining why it's useful\n\n---\n\n## Current Canonical Tag Structure\n\nDave's linkding instance has **263 canonical tags** after consolidation from 17,189 duplicates.\n\nTop categories (by bookmark count):\n- `pinboard` (4,987) - Legacy import tag\n- `ifttt` (2,639) - Legacy import tag  \n- `webdev` (1,679) - Web development\n- `design` (561) - Design\u002FUI\u002FUX\n- `content` (416) - Content\u002Fwriting\n- `cloud` (383) - Cloud\u002Fhosting\u002FSaaS\n- `business` (364) - Business\u002Fstrategy\n- `ecommerce` (308) - Shopping\u002Fmarketplace\n- `smart-home` (295) - Home automation\n- `productivity` (291) - Productivity tools\n\n**Golden Rule:** When in doubt, use broader existing tags rather than creating new specific ones.\n\n","# clinkding - Linkding Bookmark Manager CLI\n\nA modern Go-based CLI for managing bookmarks in [linkding](https:\u002F\u002Fgithub.com\u002Fsissbruecker\u002Flinkding), a self-hosted bookmark manager.\n\n## What This Does\n\n**Linkding** is a self-hosted bookmark manager (like Pocket, Instapaper). **clinkding** is the CLI that lets you manage your bookmarks from the terminal or via AI agents.\n\nThink of it as:\n- **Save for later** - Capture URLs you want to read\n- **Searchable library** - Full-text search across titles, descriptions, tags\n- **Organized collections** - Tag and bundle related bookmarks\n- **Personal archive** - Keep important links with notes and metadata\n\n## Quick Start\n\n### Initial Setup\n\n```bash\n# Interactive configuration\nclinkding config init\n\n# Or manually configure\nclinkding config set url https:\u002F\u002Fyour-linkding-instance.com\nclinkding config set token YOUR_API_TOKEN\n\n# Test connection\nclinkding config test\n```\n\n### Configuration File\n\nLocation: `~\u002F.config\u002Fclinkding\u002Fconfig.yaml`\n\n```yaml\nurl: https:\u002F\u002Flinkding.example.com\ntoken: your-api-token-here\n\ndefaults:\n  bookmark_limit: 100\n  output_format: auto\n```\n\n### Environment Variables\n\n```bash\nexport LINKDING_URL=\"https:\u002F\u002Flinkding.example.com\"\nexport LINKDING_TOKEN=\"your-api-token-here\"\n```\n\n## Core Commands\n\n### Bookmarks\n\n#### List & Search\n\n```bash\n# List recent bookmarks\nclinkding bookmarks list\n\n# Search by keyword\nclinkding bookmarks list --query \"golang tutorial\"\n\n# Filter by tag\nclinkding bookmarks list --query \"tag:programming\"\n\n# Recent bookmarks (last 7 days)\nclinkding bookmarks list --added-since \"7d\"\n\n# Unread bookmarks\nclinkding bookmarks list --query \"unread:yes\"\n\n# JSON output for scripting\nclinkding bookmarks list --json\n\n# Plain text (tab-separated)\nclinkding bookmarks list --plain\n```\n\n#### Create Bookmarks\n\n```bash\n# Simple bookmark\nclinkding bookmarks create https:\u002F\u002Fgo.dev\n\n# With metadata\nclinkding bookmarks create https:\u002F\u002Fgo.dev \\\n  --title \"Go Programming Language\" \\\n  --tags \"golang,programming,reference\" \\\n  --description \"Official Go website\" \\\n  --unread\n\n# Check if URL already exists before creating\nclinkding bookmarks check https:\u002F\u002Fgo.dev\n```\n\n#### Update Bookmarks\n\n```bash\n# Update title\nclinkding bookmarks update 42 --title \"New Title\"\n\n# Add tags\nclinkding bookmarks update 42 --add-tags \"important,work\"\n\n# Remove tags\nclinkding bookmarks update 42 --remove-tags \"old-tag\"\n\n# Mark as read\nclinkding bookmarks update 42 --read\n\n# Update description\nclinkding bookmarks update 42 --description \"Updated notes\"\n```\n\n#### Get Bookmark Details\n\n```bash\n# Full details\nclinkding bookmarks get 42\n\n# JSON output\nclinkding bookmarks get 42 --json\n```\n\n#### Archive & Delete\n\n```bash\n# Archive (hide from main list)\nclinkding bookmarks archive 42\n\n# Unarchive\nclinkding bookmarks unarchive 42\n\n# Delete permanently\nclinkding bookmarks delete 42\n```\n\n### Tags\n\n```bash\n# List all tags\nclinkding tags list\n\n# Create a tag\nclinkding tags create \"golang\"\n\n# Get tag details\nclinkding tags get 1\n\n# Plain text output\nclinkding tags list --plain\n```\n\n### Bundles\n\nBundles are collections of related bookmarks.\n\n```bash\n# List bundles\nclinkding bundles list\n\n# Create a bundle\nclinkding bundles create \"Go Resources\" \\\n  --description \"Everything related to Go programming\"\n\n# Update a bundle\nclinkding bundles update 1 --name \"Go Lang Resources\"\n\n# Get bundle details\nclinkding bundles get 1\n\n# Delete a bundle\nclinkding bundles delete 1\n```\n\n### Assets\n\nUpload and manage file attachments for bookmarks.\n\n```bash\n# List assets for a bookmark\nclinkding assets list 42\n\n# Upload a file\nclinkding assets upload 42 ~\u002FDocuments\u002Fscreenshot.png\n\n# Download an asset\nclinkding assets download 42 1 -o .\u002Fdownloaded-file.png\n\n# Delete an asset\nclinkding assets delete 42 1\n```\n\n### User Profile\n\n```bash\n# Get user profile info\nclinkding user profile\n```\n\n## Agent Usage Patterns\n\n### Save URL from Conversation\n\n```bash\n# User: \"Save this for later: https:\u002F\u002Fexample.com\"\nclinkding bookmarks create https:\u002F\u002Fexample.com \\\n  --title \"Article Title\" \\\n  --description \"Context from conversation\" \\\n  --tags \"topic,context\"\n```\n\n### Search Bookmarks\n\n```bash\n# User: \"Find my golang bookmarks\"\nclinkding bookmarks list --query \"golang\"\n\n# User: \"Show me unread programming articles\"\nclinkding bookmarks list --query \"tag:programming unread:yes\"\n\n# User: \"What did I save last week?\"\nclinkding bookmarks list --added-since \"7d\"\n```\n\n### Organize & Tag\n\n```bash\n# User: \"Tag bookmark 42 as important\"\nclinkding bookmarks update 42 --add-tags \"important\"\n\n# User: \"Create a bundle for my AI research links\"\nclinkding bundles create \"AI Research\" \\\n  --description \"Machine learning and AI papers\"\n```\n\n### Retrieve for Reading\n\n```bash\n# User: \"Give me something to read\"\nclinkding bookmarks list --query \"unread:yes\" --limit 5\n\n# User: \"Show me my golang tutorials\"\nclinkding bookmarks list --query \"tag:golang tag:tutorial\"\n```\n\n## Output Formats\n\n### Auto (Default)\nHuman-friendly tables and colors for terminal display.\n\n### JSON\n```bash\nclinkding bookmarks list --json\n```\nMachine-readable for scripting and agent parsing.\n\n### Plain Text\n```bash\nclinkding bookmarks list --plain\n```\nTab-separated values for pipe-friendly parsing.\n\n## Relative Date Filtering\n\nSupports human-friendly time ranges:\n\n```bash\n# Last 24 hours\nclinkding bookmarks list --added-since \"24h\"\n\n# Last 7 days\nclinkding bookmarks list --added-since \"7d\"\n\n# Last 6 months\nclinkding bookmarks list --modified-since \"180d\"\n```\n\n**Supported units:** `h` (hours), `d` (days), `y` (years)\n\n## Common Workflows\n\n### Morning Reading Routine\n\n```bash\n# Check unread bookmarks\nclinkding bookmarks list --query \"unread:yes\"\n\n# Get top 5 most recent\nclinkding bookmarks list --limit 5\n```\n\n### Save from Clipboard\n\n```bash\n# macOS\npbpaste | xargs -I {} clinkding bookmarks create {}\n\n# Linux\nxclip -o | xargs -I {} clinkding bookmarks create {}\n```\n\n### Batch Operations\n\n```bash\n# Tag multiple bookmarks\nfor id in 42 43 44; do\n  clinkding bookmarks update $id --add-tags \"important\"\ndone\n\n# Archive old unread bookmarks\nclinkding bookmarks list --query \"unread:yes\" --added-since \"30d\" --plain | \\\n  while read id _; do\n    clinkding bookmarks archive \"$id\"\n  done\n```\n\n### Backup Bookmarks\n\n```bash\n# Export all bookmarks as JSON\nclinkding bookmarks list --json > bookmarks-backup-$(date +%Y%m%d).json\n\n# Export specific tag\nclinkding bookmarks list --query \"tag:important\" --json > important.json\n```\n\n## Global Flags\n\nAvailable on all commands:\n\n| Flag | Description |\n|------|-------------|\n| `-c, --config \u003Cfile>` | Config file path |\n| `-u, --url \u003Curl>` | Linkding instance URL |\n| `-t, --token \u003Ctoken>` | API token |\n| `--json` | Output as JSON |\n| `--plain` | Output as plain text |\n| `--no-color` | Disable colors |\n| `-q, --quiet` | Minimal output |\n| `-v, --verbose` | Verbose output |\n\n## Exit Codes\n\n| Code | Meaning |\n|------|---------|\n| 0 | Success |\n| 1 | General error (API\u002Fnetwork) |\n| 2 | Invalid usage (bad flags\u002Fargs) |\n| 3 | Authentication error |\n| 4 | Not found |\n| 130 | Interrupted (Ctrl-C) |\n\n## Troubleshooting\n\n### Test Configuration\n\n```bash\n# Verify settings\nclinkding config show\n\n# Test connection\nclinkding config test\n```\n\n### Common Issues\n\n**Authentication Error:**\n- Verify API token in linkding web interface\n- Check URL includes protocol (`https:\u002F\u002F`)\n- Remove trailing slashes from URL\n\n**Command-Specific Help:**\n```bash\nclinkding bookmarks --help\nclinkding bookmarks create --help\n```\n\n## Links\n\n- **GitHub:** https:\u002F\u002Fgithub.com\u002Fdaveonkels\u002Fclinkding\n- **Linkding:** https:\u002F\u002Fgithub.com\u002Fsissbruecker\u002Flinkding\n- **Homebrew:** `brew install daveonkels\u002Ftap\u002Fclinkding`\n\n## Installation\n\n### Homebrew (macOS\u002FLinux)\n\n```bash\nbrew install daveonkels\u002Ftap\u002Fclinkding\n```\n\n### Go Install\n\n```bash\ngo install github.com\u002Fdaveonkels\u002Fclinkding@latest\n```\n\n### Binary Download\n\nDownload from [releases](https:\u002F\u002Fgithub.com\u002Fdaveonkels\u002Fclinkding\u002Freleases) for your platform.\n\n## Shell Completion\n\n```bash\n# Bash\nclinkding completion bash > \u002Fetc\u002Fbash_completion.d\u002Fclinkding\n\n# Zsh\nclinkding completion zsh > \"${fpath[1]}\u002F_clinkding\"\n\n# Fish\nclinkding completion fish > ~\u002F.config\u002Ffish\u002Fcompletions\u002Fclinkding.fish\n```\n\n---\n\n**Built by:** [@daveonkels](https:\u002F\u002Fgithub.com\u002Fdaveonkels)  \n**License:** MIT\n\n## Agent Workflows for Smart Bookmark Creation\n\n### Adding URLs with Automatic Metadata\n\nWhen a user says \"Add this to linkding\" or \"Save this URL\", follow this workflow:\n\n**1. Extract metadata from the URL**\n\nUse the `summarize` skill to get title and description:\n\n```bash\n# Get page metadata\nsummarize url https:\u002F\u002Fexample.com --format json\n```\n\nThis returns structured data with:\n- Title\n- Description\u002Fsummary\n- Main content\n\n**2. Infer appropriate tags from content**\n\nMap the content to **existing canonical tags only**. Do NOT create new tags.\n\nUse this canonical tag list (263 tags total):\n- **Tech:** webdev, design, programming, ai, cloud, devops, docker, linux, networking, security, privacy\n- **Content:** content, media, photography, video, audio, books, podcasting\n- **Business:** business, marketing, ecommerce, finance, career, productivity\n- **Home:** smart-home, home-assistant, esphome, iot, home-improvement\n- **Tools:** tools, cli, git, github, editor, reference, documentation\n- **Data:** data, analytics, mysql, nosql\n- **Communication:** communication, email, messaging, slack\n- **Education:** education, guide, howto, research, testing\n- **Locations:** texas, seattle, dallas (use sparingly)\n\n**Tag Selection Rules:**\n- Use 2-5 tags maximum\n- Choose the most specific applicable tags\n- If unsure, default to broader categories (e.g., `tools` over `generator`)\n- Check existing tags first: `clinkding tags list --plain | grep -i \u003Ckeyword>`\n- Never create tags like: `awesome`, `cool`, `interesting`, `resources`, `tips`\n\n**3. Create the bookmark with metadata**\n\n```bash\nclinkding bookmarks create \"https:\u002F\u002Fexample.com\" \\\n  --title \"Title from summarize\" \\\n  --description \"Summary from summarize (1-2 sentences)\" \\\n  --tags \"webdev,tools,reference\"\n```\n\n### Example Workflow\n\n**User:** \"Save this to linkding: https:\u002F\u002Fgithub.com\u002Fawesome\u002Fproject\"\n\n**Agent Actions:**\n\n```bash\n# 1. Check if already bookmarked\nclinkding bookmarks check https:\u002F\u002Fgithub.com\u002Fawesome\u002Fproject\n\n# 2. Get metadata (use summarize skill)\nsummarize url https:\u002F\u002Fgithub.com\u002Fawesome\u002Fproject --format json\n\n# 3. Analyze content and infer tags\n# From summary: \"A CLI tool for Docker container management\"\n# Canonical tags: docker, devops, cli, tools\n\n# 4. Create bookmark\nclinkding bookmarks create https:\u002F\u002Fgithub.com\u002Fawesome\u002Fproject \\\n  --title \"Awesome Project - Docker Container CLI\" \\\n  --description \"Command-line tool for managing Docker containers with enhanced features\" \\\n  --tags \"docker,devops,cli\"\n```\n\n### Tag Mapping Heuristics\n\nUse these rules to map content → canonical tags:\n\n| Content Type | Canonical Tags |\n|--------------|----------------|\n| Web development, HTML, CSS, JavaScript | `webdev`, `css`, `javascript` |\n| React, frameworks, frontend | `webdev`, `react` |\n| Design, UI\u002FUX, mockups | `design` |\n| Python, Go, Ruby code | `programming`, `python`\u002F`ruby` |\n| Docker, K8s, DevOps | `docker`, `devops`, `cloud` |\n| Home automation, ESP32, sensors | `smart-home`, `esphome`, `iot` |\n| AI, ML, LLMs | `ai`, `llm` |\n| Productivity tools, workflows | `productivity`, `tools` |\n| Finance, investing, crypto | `finance` |\n| Marketing, SEO, ads | `marketing` |\n| Shopping, deals, stores | `ecommerce` |\n| Tutorials, guides, docs | `guide`, `howto`, `documentation` |\n| Security, privacy, encryption | `security`, `privacy` |\n| Local (DFW\u002FSeattle) | `texas`, `seattle` |\n\n### Validation Before Creating\n\nAlways run these checks:\n\n```bash\n# 1. Does URL already exist?\nclinkding bookmarks check \u003Curl>\n\n# 2. Do the tags exist?\nclinkding tags list --plain | grep -iE \"^(tag1|tag2|tag3)$\"\n\n# 3. Are we using canonical tags?\n# Cross-reference against the 263 canonical tags\n# Never create new tags without explicit user request\n```\n\n### User Requests to Save Multiple Links\n\nIf user provides multiple URLs:\n\n```bash\n# Process each URL separately with metadata extraction\nfor url in url1 url2 url3; do\n  # Get metadata\n  # Infer tags\n  # Create bookmark\ndone\n```\n\n### Updating Existing Bookmarks\n\nIf user says \"Update that bookmark\" or \"Add tags to my last save\":\n\n```bash\n# Get most recent bookmark\nrecent_id=$(clinkding bookmarks list --limit 1 --plain | cut -f1)\n\n# Add tags (don't remove existing ones unless asked)\nclinkding bookmarks update $recent_id --add-tags \"new-tag\"\n\n# Update description\nclinkding bookmarks update $recent_id --description \"Updated notes\"\n```\n\n### Key Principles\n\n1. **Always fetch metadata** - Use `summarize` to get good titles\u002Fdescriptions\n2. **Use existing tags** - Never create new tags without checking canonical list\n3. **Be selective** - 2-5 tags max, choose the most specific applicable\n4. **Validate first** - Check for duplicates before creating\n5. **Provide context** - Include brief description explaining why it's useful\n\n---\n\n## Current Canonical Tag Structure\n\nDave's linkding instance has **263 canonical tags** after consolidation from 17,189 duplicates.\n\nTop categories (by bookmark count):\n- `pinboard` (4,987) - Legacy import tag\n- `ifttt` (2,639) - Legacy import tag  \n- `webdev` (1,679) - Web development\n- `design` (561) - Design\u002FUI\u002FUX\n- `content` (416) - Content\u002Fwriting\n- `cloud` (383) - Cloud\u002Fhosting\u002FSaaS\n- `business` (364) - Business\u002Fstrategy\n- `ecommerce` (308) - Shopping\u002Fmarketplace\n- `smart-home` (295) - Home automation\n- `productivity` (291) - Productivity tools\n\n**Golden Rule:** When in doubt, use broader existing tags rather than creating new specific ones.\n\n",{"name":5,"homepage":24,"metadata":25,"description":7},"https:\u002F\u002Fgithub.com\u002Fdaveonkels\u002Fclinkding",{"clawdis":26},{"emoji":27,"install":28,"requires":40},"🔖",[29,35],{"id":30,"bins":31,"kind":32,"label":33,"formula":34},"homebrew",[5],"brew","Install clinkding (Homebrew)","daveonkels\u002Ftap\u002Fclinkding",{"id":36,"bins":37,"kind":36,"label":38,"module":39},"go",[5],"Install clinkding (Go)","github.com\u002Fdaveonkels\u002Fclinkding@latest",{"bins":41},[5],"main","f9d3fe7cf9ac8f1ea63a0d96e98e1f510a3814db","skills\u002Fdaveonkels\u002Fclinkding",1,"https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills","https:\u002F\u002Fgithub.com\u002Fjavimosch","intrane.fr","Building robust, open-source infrastructure for the commons. AI-leveraged, self-hosted, built to last.","2026-06-07 03:34:58",{"source":8,"skillName":5,"commands":52,"prompt":62,"zipAvailable":63},[53,56,59],{"tool":54,"command":55},"npx","npx skills add javimosch\u002Fopen-claw-skills --skill clinkding",{"tool":57,"command":58},"bunx","bunx skills add javimosch\u002Fopen-claw-skills --skill clinkding",{"tool":60,"command":61},"pnpm","pnpm dlx skills add javimosch\u002Fopen-claw-skills --skill clinkding","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fdaveonkels\u002Fclinkding\u002FSKILL.md",true,[],[66,74,81,88,95,102],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":73},"01M778GGXG2VQ0YF31W2MKGMQZ","crowd-prompting","A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzzadrian\u002Fcrowd-prompting\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":73},"01M778G7BH8SBJ9FJ6C3G7CB1K","ceaser","Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp \u003Csubcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir\u002FUltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyra-v21\u002Fceaser\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":73},"01M778FYCJQZWFKKX5FYMK3S47","ceaser-send","Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp \u003Csubcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir\u002FUltraHonk zero-knowledge proofs.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyra-v21\u002Fceaser-send\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":73},"01M778FQQNSEYA3HJKZBPQ4M9Z","dilemm-ai","Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyori\u002Fdilemm-ai\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":73},"01M778FGVZX7QA2TF9BFMM37FY","moldium","Post and manage content on the Moldium blog platform. Triggered by \"post to Moldium\", \"write a blog post\", \"publish an article\", etc.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyom45\u002Fmoldium\u002FSKILL.md",[],[],{"skillNo":103,"name":104,"nameZh":6,"description":105,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":106,"categories":107,"keywords":108,"publishedAt":73},"01M778F88D8PQ9MQ0KNW2TJ8ZH","arxiv-paper-reviews","Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date\u002Fcategory\u002Finterest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http:\u002F\u002Fweakaccept.top:8000\u002F.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzxrys\u002Farxiv-paper-reviews\u002FSKILL.md",[],[]]