# Send joplin to your agent
Use the source page and any available docs to guide the install because the item currently does not return a direct package file.
## Fast path
- Open the source page via Open source listing.
- If you can obtain the package, extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the source page and extracted files.
## Suggested prompts
### New install

```text
I tried to install a skill package from Yavira, but the item currently does not return a direct package file. Inspect the source page and any extracted docs, then tell me what you can confirm and any manual steps still required.
```
### Upgrade existing

```text
I tried to upgrade a skill package from Yavira, but the item currently does not return a direct package file. Compare the source page and any extracted docs with my current installation, then summarize what changed and what manual follow-up I still need.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "joplin",
    "name": "joplin",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/davek-dev/joplin",
    "canonicalUrl": "https://clawhub.ai/davek-dev/joplin",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/joplin",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=joplin",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "manual_only",
    "sourceHealth": {
      "source": "tencent",
      "slug": "joplin",
      "status": "source_issue",
      "reason": "not_found",
      "recommendedAction": "review_source",
      "checkedAt": "2026-05-12T04:18:08.107Z",
      "expiresAt": "2026-05-13T04:18:08.107Z",
      "httpStatus": 404,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=joplin",
      "contentType": "text/plain",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=joplin",
        "contentDisposition": null,
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "joplin"
      },
      "scope": "item",
      "summary": "Known item issue.",
      "detail": "This item's current download entry is known to bounce back to a listing or homepage instead of returning a package file.",
      "primaryActionLabel": "Open source listing",
      "primaryActionHref": "https://clawhub.ai/davek-dev/joplin"
    },
    "validation": {
      "installChecklist": [
        "Open the source listing and confirm there is a real package or setup artifact available.",
        "Review SKILL.md before asking your agent to continue.",
        "Treat this source as manual setup until the upstream download flow is fixed."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/joplin",
    "downloadUrl": "https://openagent3.xyz/downloads/joplin",
    "agentUrl": "https://openagent3.xyz/skills/joplin/agent",
    "manifestUrl": "https://openagent3.xyz/skills/joplin/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/joplin/agent.md"
  }
}
```
## Documentation

### Joplin CLI Skill

Use joplin CLI to interact with Joplin notes.

### ⚠️ Important: Use CLI, Not SQL

Always use the joplin CLI for editing notes. Do not modify the SQLite database directly unless absolutely necessary. Direct database edits can cause sync conflicts and data loss.

### Setup

If Joplin is not configured with WebDAV, configure it:

joplin config sync.target 6
joplin config sync.6.path "https://your-webdav-server/path"
joplin config sync.6.username "your-username"
joplin config sync.6.password "your-password"
joplin sync

### List Notebooks and Notes

joplin ls                          # List notebooks
joplin ls "Notebook Name"          # List notes in a notebook
joplin status                      # Show sync status and note counts
joplin ls -l                       # List with IDs

### Read Note

joplin cat <note-id>               # Display note content
joplin cat "Note Title"            # Also works with title
joplin note <note-id>              # Open note in editor

### Create Note

joplin mknote "Note Title"         # Create note in default notebook
joplin mknote "Note Title" --notebook "Notebook Name"
joplin mkbook "New Notebook"       # Create new notebook

Tip: Always ask the user which notebook to use. Use:

joplin use — shows current notebook
joplin use "Notebook Name" — switch to a notebook
joplin ls — see all notebooks

### Edit Note

joplin edit --note <note-id>       # Edit note in editor
joplin set <note-id> title "New title"  # Change note title

### Delete Note

joplin rmnote <note-id>            # Delete note
joplin rmbook "Notebook Name"      # Delete notebook

### Move Notes Between Notebooks

joplin mv "Note Title" "Target Notebook"

### Todos

joplin todos                       # List all todos
joplin todo <note-id>              # Toggle todo status
joplin done <note-id>              # Mark as done
joplin undone <note-id>            # Mark as not done

### Sync

joplin sync                        # Sync with WebDAV server

### Export

joplin export <note-id> --format md
joplin export <note-id> --format html
joplin export <note-id> --format pdf

### Import

joplin import /path/to/note.md --notebook "Notebook Name"

### Search

Note: joplin search is only available in GUI mode. Use joplin ls and pipe to grep instead.

### All Joplin Commands

attach, batch, cat, config, cp, done, e2ee, edit, export, geoloc, help, 
import, ls, mkbook, mknote, mktodo, mv, ren, restore, rmbook, rmnote, 
server, set, share, status, sync, tag, todo, undone, use, version

### Referencing Notes and Notebooks

A note or notebook can be referred to by:

Title: "Note Title"
ID: fe889 (get from joplin ls -l)
Shortcuts:

$n — Currently selected note
$b — Currently selected notebook
$c — Currently selected item

### Interactive Shell Mode

Joplin can run interactively (like a shell). Start with just joplin:

joplin                          # Start interactive mode

### Shell Commands (prefix with :)

CommandDescription:syncSync with WebDAV server:quit or :qExit Joplin:helpShow help:open <note-id>Open a note

### Shell Mode Shortcuts

e — Edit current note
i — Insert new note
Space — Select item
Enter — Open note

### Example Workflow

# Create a notebook
joplin mkbook "My notebook"

# Switch to it
joplin use "My notebook"

# Create a note
joplin mknote "My note"

# View notes with IDs
joplin ls -l

# Edit a note's title
joplin set <note-id> title "New title"

### Kanban Notes (YesYouKan Plugin)

Some notebooks use the YesYouKan kanban plugin for visual kanban boards. These notes have a specific format that must be preserved when editing:

### Kanban Format

# Notebook Name

# Backlog

## Task 1

Description here

## Task 2



# In progress

## Another Task

Details



# Done

## Completed Task

Result

\`\`\`kanban-settings
# Do not remove this block

### ⚠️ Kanban Formatting Rules

1. **Always include the kanban-settings block** at the end of the note with the exact format:

# Do not remove this block

2. **Use \`##\` for task headings** (not \`#\`)

3. **Keep column headings** as \`# Backlog\`, \`# In progress\`, \`# Done\`

4. **Preserve blank lines** between tasks — these are visible in the kanban view

5. **After editing a kanban note, always run \`joplin sync\`** to upload changes

6. **Verify changes with \`joplin cat <note-id>\`** to ensure formatting is correct

### Moving Tasks Between Columns

When moving a task, simply move the \`##\` task section from one column to another.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: davek-dev
- Version: 1.3.2
## Source health
- Status: source_issue
- Known item issue.
- This item's current download entry is known to bounce back to a listing or homepage instead of returning a package file.
- Health scope: item
- Reason: not_found
- Checked at: 2026-05-12T04:18:08.107Z
- Expires at: 2026-05-13T04:18:08.107Z
- Recommended action: Open source listing
## Links
- [Detail page](https://openagent3.xyz/skills/joplin)
- [Send to Agent page](https://openagent3.xyz/skills/joplin/agent)
- [JSON manifest](https://openagent3.xyz/skills/joplin/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/joplin/agent.md)
- [Download page](https://openagent3.xyz/downloads/joplin)