joplin SKILL.md skillA
joplin from zrong/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add zrong/skills/joplin@git:20261011.da39543Pins git:20261011.da39543 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- zrong/skills
- Path
joplin/SKILL.md- Versions recorded
- 3
- Latest version
- git:20261011.da39543, committed Oct 11, 2026
- First version recorded
- Mar 19, 2026
- Size
- 3,650 bytes
- Repository stars
- 13
- License
- none declared
完整的 Joplin REST API 客户端，支持笔记(Notes)、笔记本(Folders)、标签(Tags)、资源/附件(Resources)的 CRUD 操作，以及搜索、修订版本和事件流。.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Joplin Skill (Complete API)
此 Skill 提供了对 Joplin REST API 的全面访问，允许 Agent 深度管理 Joplin 笔记库。
## 环境配置
在 `agent_config.toml` 中配置：
```toml
[joplin]
base_url = "http://localhost:41184"
api_key = ""
api_key_env = "JOPLIN_API_KEY"
```
`api_key` 是 Web Clipper 设置中的授权密钥。直接值非空时优先使用，否则读取
`api_key_env` 指定的环境变量；脚本不会自动加载 `.env`。旧配置 `token` / `token_env`
应改名为 `api_key` / `api_key_env`。请求仍按 Joplin 协议使用 `token` query 参数。
配置查找顺序为：当前工作目录、skill 目录、当前 Git 项目根目录、
`~/.agents/agent_config.toml`。密钥为空时，联网操作在请求前停止。
可将 [agent_config.example.toml](agent_config.example.toml) 的 section 合并到现有配置。
## 功能列表与命令指南
建议使用 `uv run --project joplin/scripts joplin/scripts/joplin_tool.py --non-interactive <command>` 执行。
### 1. 全局与系统
- **检查连接**: `ping`
- **获取事件流**: `events [--cursor <cursor>] [--limit <limit>]`
- **获取修订版本**:
- `revision list`
- `revision get <id>`
### 2. 笔记 (Note)
- **列出笔记**: `note list [--limit 10] [--page 1] [--fields "id,title"] [--order-by "updated_time"] [--order-dir "DESC"]`
- **获取详情**: `note get <id>`
- **创建笔记**: `note create --title "标题" [--body "内容"] [--body-from <文件路径>] [--parent <folder_id>]`
- `--body` 适用于短文本；长文本或含有多行内容的，推荐用 `--body-from <文件路径>` 从本地文件读取
…Read the whole file at its exact version.
How to install
mdr add zrong/skills/joplin@sha256:8878330c04264ef9The line at the top of this page pins the label git:20261011.da39543, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_q5qwyra2kgt7qveu)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 3 versions of this file, between Mar 19, 2026 and Oct 11, 2026, about one every 103 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261011.da39543 latest | 2026-10-11 | da39543 | 3,650 B | A | view · diff |
| git:20260329.db8d868 | 2026-03-29 | db8d868 | 3,060 B | A | view · diff |
| git:20260319.d841107 | 2026-03-19 | d841107 | 2,869 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (3650 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
zrong/skills · 13 stars · license none declared · pushed 2026-10-29 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_q5qwyra2kgt7qveu GET https://markdownregistry.com/api/v1/resolve?ref=zrong/skills/joplin GET https://markdownregistry.com/api/v1/blob/8878330c04264ef97dbb2aa464e66cb3bec2d9b3fb31b89fa0de7a8c2547f7c3
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.