siyuan

Interact with the SiYuan Note kernel API for CRUD operations on blocks and documents.

Updated Jul 13, 2026
One-click install
npx skills add https://github.com/zeronx798/demo-hermes-agent --skill siyuan-zeronx798
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: siyuan
Source: https://github.com/zeronx798/demo-hermes-agent/tree/main/optional-skills/productivity/siyuan
Command: npx skills add https://github.com/zeronx798/demo-hermes-agent --skill siyuan-zeronx798

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq.

What problem does it solve?

This Skill solves the friction of manually interacting with your SiYuan knowledge base by providing a direct interface to search, create, and manage blocks and documents programmatically.

Core Features & Use Cases

  • Automated Knowledge Management: Perform bulk updates, block creation, or document renaming without opening the desktop application.
  • Advanced Retrieval: Execute SQL queries against your local block database to find specific information across your entire knowledge base.
  • Use Case: Automatically append daily meeting notes to a specific document or search for all blocks tagged with a specific project name to generate a summary report.

Quick Start

Use the siyuan skill to search for all blocks containing the phrase project updates and return the results.

Frequently Asked Questions about siyuan

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

FAQPage Schema
How do I automate knowledge base management in SiYuan without opening the desktop app?

You can automate SiYuan knowledge base management by using this Skill to send authenticated POST requests to the local kernel API for block and document CRUD operations.

How do I run SQL queries against my SiYuan notes to find specific information?

Running SQL queries against your SiYuan notes is done by sending API requests to the local kernel, allowing you to retrieve specific block data across your entire knowledge base.

Do I need curl and jq to interact with the SiYuan API?

Yes, curl and jq are required dependencies to execute authenticated POST requests against the local SiYuan instance and parse the returned structured data.

Can I automatically append daily meeting notes to a specific document in my PKM system?

You can automatically append daily meeting notes to a specific SiYuan document by using the API to programmatically create and update blocks within your personal knowledge management system.

What is the best way to perform bulk updates on SiYuan blocks and documents?

Performing bulk updates on SiYuan blocks and documents is best done by automating API calls to the local kernel, bypassing the desktop application for direct structured data organization.

How does the SiYuan API handle block creation and document renaming?

The SiYuan API handles block creation and document renaming through authenticated POST requests sent to the local kernel, enabling direct CRUD operations on structured block data.