siyuan

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq.

What problem does it solve?

This skill bridges the gap between your AI agent and your personal knowledge base, allowing you to programmatically search, update, and manage your notes without leaving your chat interface.

Core Features & Use Cases

  • Knowledge Retrieval: Perform full-text or SQL-based searches across your entire SiYuan database to find specific blocks or documents.
  • Content Management: Create, update, or delete blocks and documents directly, enabling automated note-taking and organization.
  • Use Case: Automatically append meeting summaries or research findings to specific daily notes in your SiYuan notebook using simple natural language commands.

Quick Start

Use the siyuan skill to search for all blocks containing the phrase project roadmap and display the results.

Frequently Asked Questions about siyuan

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

FAQPage Schema
How do I programmatically search my SiYuan knowledge base using SQL?

To search your SiYuan knowledge base, the skill sends SQL statements to the SiYuan kernel API, enabling full-text searches and complex block-level queries across your self-hosted notes database.

How do I create and update notes in SiYuan from an AI chat interface?

To manage notes in SiYuan from a chat interface, the skill executes CRUD operations via the kernel API, allowing you to create, update, or delete blocks and documents for automated note-taking.

Do I need an API token to automate interactions with my SiYuan notes?

Yes, automating interactions with your SiYuan notes requires an active self-hosted SiYuan instance with a valid API token, along with standard curl utilities for network communication.

Can I automatically append research findings to specific daily notes in SiYuan?

Yes, you can append research findings to specific daily notes in SiYuan by performing block creation and modification operations through the SiYuan kernel API using natural language commands.

What dependencies are required to connect an AI agent to a personal knowledge base?

Connecting an AI agent to your personal knowledge base via this approach requires curl and jq installed, which handle network communication and JSON parsing for the SiYuan API interactions.