Description

Manage bookmarks with Linkding. Use when the user asks to "save a bookmark", "add link", "search bookmarks", "list my bookmarks", "find saved links", "tag a bookmark", "archive bookmark", "check if URL is saved", "list tags", "create bundle", or mentions Linkding bookmark management.

README (SKILL.md)

Linkding Bookmark Manager

Name: Linkding
Author: jmagar

Query and manage bookmarks via the Linkding REST API.

Setup

Config: ~/.clawdbot/credentials/linkding/config.json

{
  "url": "https://linkding.example.com",
  "apiKey": "your-api-token"
}

Get your API token from Linkding Settings page.

Quick Reference

List/Search Bookmarks

# List recent bookmarks
./scripts/linkding-api.sh bookmarks

# Search bookmarks
./scripts/linkding-api.sh bookmarks --query "python tutorial"

# List archived
./scripts/linkding-api.sh bookmarks --archived

# Filter by date
./scripts/linkding-api.sh bookmarks --modified-since "2025-01-01T00:00:00Z"

Create Bookmark

# Basic
./scripts/linkding-api.sh create "https://example.com"

# With metadata
./scripts/linkding-api.sh create "https://example.com" \
  --title "Example Site" \
  --description "A great resource" \
  --tags "reference,docs"

# Archive immediately
./scripts/linkding-api.sh create "https://example.com" --archived

Check if URL Exists

./scripts/linkding-api.sh check "https://example.com"

Returns existing bookmark data if found, plus scraped metadata.

Update Bookmark

./scripts/linkding-api.sh update 123 --title "New Title" --tags "newtag1,newtag2"

Archive/Unarchive

./scripts/linkding-api.sh archive 123
./scripts/linkding-api.sh unarchive 123

Delete

./scripts/linkding-api.sh delete 123

Bundles (saved searches)

# List bundles
./scripts/linkding-api.sh bundles

# Create bundle
./scripts/linkding-api.sh bundle-create "Work Resources" \
  --search "productivity" \
  --any-tags "work,tools" \
  --excluded-tags "personal"

Response Format

All responses are JSON. Bookmark object:

{
  "id": 1,
  "url": "https://example.com",
  "title": "Example",
  "description": "Description",
  "notes": "Personal notes",
  "is_archived": false,
  "unread": false,
  "shared": false,
  "tag_names": ["tag1", "tag2"],
  "date_added": "2020-09-26T09:46:23.006313Z",
  "date_modified": "2020-09-26T16:01:14.275335Z"
}

Common Patterns

Save current page for later:

./scripts/linkding-api.sh create "$URL" --tags "toread" --unread

Quick search and display:

./scripts/linkding-api.sh bookmarks --query "keyword" --limit 10 | jq -r '.results[] | "\(.title) - \(.url)"'

Bulk tag update: Update via API PATCH with new tag_names array.

Usage Guidance

This skill appears to be a straightforward Linkding REST client, but pay attention to these points before installing: (1) The metadata omitted required runtime items — you must provide an API token and Linkding URL (either in ~/.clawdbot/credentials/linkding/config.json or via LINKDING_URL/LINKDING_API_KEY env vars). (2) The included script depends on curl and jq; install those or the script will fail. (3) Verify the LINKDING_URL you configure is the intended server (don't point it at an unknown third-party), since the script will send your API token to that URL. (4) Inspect scripts/linkding-api.sh yourself (it is plain shell) to confirm you are comfortable with its behavior. If you want to proceed, create the config file manually and only grant the API token minimal permissions; if the metadata or registry page cannot explain why credentials/config requirements were omitted, consider contacting the skill author or using an alternative with correct metadata.

Capability Analysis

Type: OpenClaw Skill Name: linkding Version: 1.0.1 The skill is designed to manage bookmarks via the Linkding REST API. It correctly loads API credentials (URL and API Key) from the designated secure location (`~/.clawdbot/credentials/linkding/config.json`) or environment variables. All network interactions are performed using `curl` against the user-configured Linkding instance, and input parameters are properly sanitized using `jq` for URL encoding and JSON payload construction. There is no evidence of data exfiltration to unauthorized endpoints, malicious execution, persistence mechanisms, or prompt injection attempts against the agent beyond its stated purpose. The functionality is entirely aligned with its description.

Capability Assessment

✓ Purpose & Capability

The name/description (Linkding bookmark management) matches the included files: SKILL.md, README, and a shell API helper that implements listing, creating, updating, tagging, bundles, etc. The functionality described is coherent with a Linkding REST client.

✓ Instruction Scope

SKILL.md directs the agent to use the provided scripts/linkding-api.sh and to store a Linkding URL/API token in ~/.clawdbot/credentials/linkding/config.json (or provide env vars). The instructions do not request unrelated files, system-wide secrets, or external endpoints beyond the Linkding server URL the user supplies.

ℹ Install Mechanism

There is no install spec (instruction-only), which is low risk. However, the shipped script requires runtime tools (curl and jq) but the skill metadata declares no required binaries. That mismatch could cause runtime failures or surprise dependency assumptions.

⚠ Credentials

Registry metadata lists no required environment variables or config paths, but the script expects LINKDING_URL and LINKDING_API_KEY (or a config file at ~/.clawdbot/credentials/linkding/config.json) and optionally LINKDING_CONFIG. These are appropriate for the skill's purpose, but the metadata omission is a notable inconsistency: the skill will need an API token (sensitive secret) and a server URL which the registry did not declare.

✓ Persistence & Privilege

The skill does not request always: true and does not modify other skills or system-wide settings. It reads a user-provided config file in the user's home directory and does not appear to persist additional credentials or perform privileged system changes.

Version History

v1.0.1

- Added README.md file. - Added explicit version field (1.0.1) to SKILL.md.

v1.0.0

Initial release: full API wrapper for bookmarks, tags, and bundles

Metadata

Slug linkding

Version 1.0.1

License —

All-time Installs 2

Active Installs 2

Total Versions 2

Frequently Asked Questions

What is Linkding?

Manage bookmarks with Linkding. Use when the user asks to "save a bookmark", "add link", "search bookmarks", "list my bookmarks", "find saved links", "tag a bookmark", "archive bookmark", "check if URL is saved", "list tags", "create bundle", or mentions Linkding bookmark management. It is an AI Agent Skill for Claude Code / OpenClaw, with 2098 downloads so far.

How do I install Linkding?

Run "/install linkding" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Linkding free?

Yes, Linkding is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Linkding support?

Linkding is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Linkding?

It is built and maintained by jmagar (@jmagar); the current version is v1.0.1.

More Skills

Linkding