siyuan

Search and manage SiYuan knowledge base content via the kernel API.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/JKhyro/HERMES-AGENT --skill siyuan-jkhyro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: siyuan
Source: https://github.com/JKhyro/HERMES-AGENT/tree/main/optional-skills/productivity/siyuan
Command: npx skills add https://github.com/JKhyro/HERMES-AGENT --skill siyuan-jkhyro

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of manually navigating a self-hosted SiYuan workspace by letting an AI search, read, create, update, and organize notes through the kernel API.

Core Features & Use Cases

  • Search and retrieval: Find blocks or documents with full-text search or SQL queries.
  • Content management: Read block Kramdown, inspect children and attributes, create notebooks and documents, append or update blocks, rename documents, and export Markdown.
  • Practical use case: Ask for a meeting note summary, then have the Skill locate the right document, extract the relevant blocks, and update the notebook with the new content.

Quick Start

Use the SiYuan skill to connect to your instance, find the target note or block, and then create or update the content you want.

Frequently Asked Questions about siyuan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage my SiYuan knowledge base content through an API?

You can manage your SiYuan knowledge base through the kernel API by sending POST-based JSON requests to search, read, create, update, and delete blocks and documents, requiring an SIYUAN_TOKEN for authentication.

How do I export Markdown from specific blocks in a self-hosted SiYuan workspace?

Exporting Markdown from SiYuan blocks involves sending POST-based JSON requests via the kernel API to read the target block's Kramdown content and convert it for your self-hosted note workflows.

Can I run SQL queries to lookup blocks in my SiYuan notes database?

Yes, you can run safe SELECT-only SQL queries via the SiYuan kernel API to lookup specific blocks and documents, ensuring strict ID validation to protect your knowledge base integrity.

What do I need to connect to my SiYuan instance and automate note management?

To connect to your SiYuan instance, you need curl and jq installed, an SIYUAN_TOKEN, and optionally a SIYUAN_URL, allowing you to automate content management via POST-based JSON requests.

Is it possible to update and rename documents in a SiYuan knowledge base using curl?

Updating and renaming documents in a SiYuan knowledge base is possible by sending POST-based JSON requests with curl, targeting the kernel API to append, update, or rename specific blocks.