siyuan

Search, read, and modify SiYuan knowledge base content via kernel API.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq.

What problem does it solve?

This skill solves the friction of manually navigating and updating your personal knowledge base by providing a direct, programmatic interface to the SiYuan kernel API.

Core Features & Use Cases

  • Full-Text & SQL Search: Instantly locate specific blocks or documents using powerful search queries.
  • Content Management: Create, update, rename, or delete blocks and documents directly from your agent interface.
  • Use Case: You can ask your agent to find all meeting notes from last month, summarize them, and append a new action item block to the relevant document without ever leaving your chat.

Quick Start

Use the siyuan skill to search for all blocks containing the keyword project and return the top five results.

Frequently Asked Questions about siyuan

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

FAQPage Schema
How do I automate searching and editing my SiYuan knowledge base?

Automate SiYuan knowledge base searching and editing by using a programmatic interface to the SiYuan kernel API, enabling direct information retrieval and document modification without manual navigation.

Can I use SQL queries to find specific blocks in my SiYuan notes?

Yes, you can find specific blocks in SiYuan notes using SQL queries and full-text search through the kernel API, returning targeted results for immediate content management.

What do I need to connect to the SiYuan kernel API for automated note-taking?

To connect to the SiYuan kernel API for automated note-taking, you need curl and jq installed to execute and parse JSON-based API requests against your self-hosted SiYuan instance.

What's the best way to update and organize documents in a self-hosted SiYuan instance?

The best way to update and organize documents in a self-hosted SiYuan instance is via the kernel API, which allows you to programmatically create, update, rename, or delete blocks and documents directly.

Does the SiYuan API support appending new blocks to existing documents automatically?

Yes, the SiYuan API supports appending new blocks to existing documents automatically, allowing agents to add content like action items to relevant notes through JSON-based requests.

Why does querying my knowledge base via the API return parsing errors?

Querying your knowledge base via the API returns parsing errors if jq is missing, as jq is required to correctly parse the JSON responses returned by the SiYuan kernel API requests.