Agent skill

Siyuan MCP Timeline

by yangtaihong59 in yangtaihong59/siyuan-plugins-mcp-sisyphus

MCP playbook for SiYuan document timelines. An agent skill from yangtaihong59/siyuan-plugins-mcp-sisyphus.

MITAuto-check passedAgent Workflows

Install Siyuan MCP Timeline

skills CLI
$ npx skills add yangtaihong59/siyuan-plugins-mcp-sisyphus --skill siyuan-mcp-timeline -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install yangtaihong59/siyuan-plugins-mcp-sisyphus siyuan-mcp-timeline --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/yangtaihong59/siyuan-plugins-mcp-sisyphus.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/siyuan-mcp/siyuan-mcp-timeline .claude/skills/siyuan-mcp-timeline && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
siyuan-mcp-timeline
GitHub stars
116
Token cost
~647 tokens
SKILL.md length
240 words
Files
2
Skills in repo
30
Repo updated
First seen
Licence
MIT

At a glance

MCP playbook for SiYuan document timelines. An agent skill from yangtaihong59/siyuan-plugins-mcp-sisyphus.

  • Create named snapshot nodes
  • SKILL.md covers Create and compare nodes and Delete or roll back
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Compare document versions

What it does

Siyuan MCP Timeline is an agent skill from yangtaihong59/siyuan-plugins-mcp-sisyphus. MCP playbook for SiYuan document timelines. Use to list or create named snapshot nodes, compare document versions, remove node tags, and safely roll back a document or one changed block.

Its SKILL.md is about 650 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Agent Workflows, covering MCP servers. It works with Model Context Protocol. The repository describes itself as: 一个用于连接Agent与Siyuan的工具. The licence is MIT.

When your agent uses it

  • Create named snapshot nodes
  • Compare document versions
  • Remove node tags
  • Safely roll back a document

Example prompts

  • “/siyuan-mcp-timeline”

What it can do on your machine

Read from SKILL.md and the folder at commit d2ad534. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Siyuan MCP Timeline loads about 647 tokens when it runs. Until then it costs about 52 tokens; SKILL.md has 240 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~52
When it runs · the whole SKILL.md, loaded when a task matches
~647

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from yangtaihong59/siyuan-plugins-mcp-sisyphus at commit d2ad534, republished under its MIT licence (© yangtaihong59). 240 words, ~647 tokens.

Download SKILL.mdSave it as .claude/skills/siyuan-mcp-timeline/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
siyuan-mcp-timeline
description
MCP playbook for SiYuan document timelines. Use to list or create named snapshot nodes, compare document versions, remove node tags, and safely roll back a document or one changed block.

Manage SiYuan Document Timelines with MCP

Resolve and read the document first. Use document-scoped nodes for one document and global nodes only when the same named snapshot should be discoverable across documents.

Create and compare nodes

List existing nodes before creating a new one:

text
timeline(action="list_nodes", scope="document", documentId="<doc-id>", page=1, pageSize=50)
text
timeline(action="create_node", name="Before revision", scope="document", documentId="<doc-id>")

Keep the returned tag as the stable identifier. After content changes, compare the same document with that tag:

text
timeline(action="compare_node", documentId="<doc-id>", tag="<timeline-tag>", page=1, pageSize=20, includeUnchanged=false)

compare_node creates an untagged current-state workspace snapshot before calculating the document diff. Paginate changed blocks with page and pageSize; request unchanged blocks only when they are required for context.

Delete or roll back

delete_node removes the protective tag but retains the underlying snapshot. rollback_document restores only the selected document file, not the whole workspace. rollback_block accepts only a fresh opaque changeKey from compare_node; it recalculates the diff and rejects stale or unsafe changes.

Before any delete or rollback, show the exact document, node name/tag, and consequence, then obtain explicit approval. These actions require rwd permission and may be disabled by default. Never bypass an unavailable dangerous action; inspect siyuan://help/action/timeline/rollback_document and ask the user to enable it when appropriate.

After approval, use the narrowest operation that satisfies the request:

text
timeline(action="rollback_block", documentId="<doc-id>", tag="<timeline-tag>", changeKey="<fresh-change-key>")
text
timeline(action="rollback_document", documentId="<doc-id>", tag="<timeline-tag>")
text
timeline(action="delete_node", tag="<timeline-tag>", documentId="<doc-id>")

After rollback, read the document again. After node creation or deletion, list nodes again. For a reversible rollback test, create a named protection node for the current state, roll back to the target, verify it, then restore from the protection node and verify again; obtain approval for both rollback operations.

© yangtaihong59, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/siyuan-mcp/siyuan-mcp-timeline of yangtaihong59/siyuan-plugins-mcp-sisyphus.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit d2ad534

Compare with similar skills

Siyuan MCP Timeline next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Siyuan MCP Timeline compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Siyuan MCP Timeline this skillyangtaihong59/siyuan-plugins-mcp-sisyphus116—~647Automated safety check: PassMIT
MCP Server Builderanthropics/skills180k63 repos~2.3kAutomated safety check: PassApache-2.0
MCP Server BuildershareAI-lab/learn-claude-code78k4 repos~1.2kAutomated safety check: PassMIT
MCP Integration for Pluginsanthropics/claude-plugins-official38k11 repos~3.1kAutomated safety check: PassApache-2.0
Crush Configurationcharmbracelet/crush29k—~3.7kAutomated safety check: PassCustom licence
Context Mode Output Sandboxmksglu/context-mode26k—~4.1kAutomated safety check: PassCustom licence

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 63 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • MCP Server Builder

    shareAI-lab/learn-claude-code

    Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.

    78k GitHub starsUsed in 4 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • MCP Integration for Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.

    38k GitHub starsUsed in 11 repos~3.1k tokens
    Agent WorkflowsAuto-check passed
  • Crush Configuration

    charmbracelet/crush

    Explains how to configure the Crush coding agent with crushrc or crush.json, covering providers, models, LSPs, MCP servers, hooks, permissions and config precedence.

    29k GitHub stars~3.7k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Context Mode Output Sandbox

    mksglu/context-mode

    Routes large command, file, API and browser output through context-mode tools so only the needed result enters the agent's context, instead of dumping it via Bash.

    26k GitHub stars~4.1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Migrates the compatible subset of settings and global file-based MCP servers from the Warp desktop app into Warp Agent CLI without exposing credentials or state.

    65k GitHub starsUsed in 1 repo~2.1k tokens
    Agent WorkflowsAuto-check passed

More from yangtaihong59/siyuan-plugins-mcp-sisyphus

All 30 skills in this repo
  • Siyuan Built Cjs Live Test

    yangtaihong59/siyuan-plugins-mcp-sisyphus

    使用仓库刚构建的 dist/mcp-server.cjs 与 cli/dist/cli.cjs,在真实思源实例的隔离测试笔记本中执行端到端验收。用于验证工具或 action 修改、严格安全写入、短哈希预检租约、幂等重放、状态变化拒绝、HTTP/stdio/CLI 一致性,以及用户要求“实际测试”“真实笔记本测试”“全部 action 测试”或“不要只跑 mock”时。

    116 GitHub stars~1.3k tokensUpdated 3 days ago
    Auto-check passed
  • Claude Desktop MCP App

    yangtaihong59/siyuan-plugins-mcp-sisyphus

    Configure, repair, and verify MCP servers and MCP Apps in Claude Desktop on macOS.

    116 GitHub stars~1.2k tokensUpdated 3 days ago
    Auto-check passed
  • Git Workflow Cn

    yangtaihong59/siyuan-plugins-mcp-sisyphus

    Chinese git workflow conventions including commit message generation and merge practices.

    116 GitHub stars~941 tokensUpdated 3 days ago
    Auto-check passed
  • Siyuan MCP Browse Read

    yangtaihong59/siyuan-plugins-mcp-sisyphus

    MCP playbook for browsing and reading SiYuan notes. An agent skill from yangtaihong59/siyuan-plugins-mcp-sisyphus.

    116 GitHub stars~684 tokensUpdated 3 days ago
    Auto-check passed
  • Siyuan MCP Create Edit

    yangtaihong59/siyuan-plugins-mcp-sisyphus

    MCP playbook for creating and editing SiYuan documents and blocks.

    116 GitHub stars~665 tokensUpdated 3 days ago
    Auto-check passed
  • Siyuan MCP Sisyphus

    yangtaihong59/siyuan-plugins-mcp-sisyphus

    Top-level skill for operating SiYuan Note through the Sisyphus MCP server.

    116 GitHub stars~1.3k tokensUpdated 3 days ago
    Auto-check passed

Categories

Questions about Siyuan MCP Timeline

What does Siyuan MCP Timeline do?

MCP playbook for SiYuan document timelines. An agent skill from yangtaihong59/siyuan-plugins-mcp-sisyphus. Siyuan MCP Timeline is an agent skill from yangtaihong59/siyuan-plugins-mcp-sisyphus. MCP playbook for SiYuan document timelines.

When should I use Siyuan MCP Timeline?

Siyuan MCP Timeline fits situations like: create named snapshot nodes; compare document versions; remove node tags; safely roll back a document.

How do I install Siyuan MCP Timeline in Claude Code?

Run `npx skills add yangtaihong59/siyuan-plugins-mcp-sisyphus --skill siyuan-mcp-timeline -a claude-code`. Or copy the skill folder (skills/siyuan-mcp/siyuan-mcp-timeline in yangtaihong59/siyuan-plugins-mcp-sisyphus) into .claude/skills/siyuan-mcp-timeline in your project. Claude Code loads it when a task matches its description.

How do I install Siyuan MCP Timeline in Codex?

Run `npx skills add yangtaihong59/siyuan-plugins-mcp-sisyphus --skill siyuan-mcp-timeline -a codex`. Or copy the skill folder (skills/siyuan-mcp/siyuan-mcp-timeline in yangtaihong59/siyuan-plugins-mcp-sisyphus) into .agents/skills/siyuan-mcp-timeline in your project. Codex loads it when a task matches its description.

Can I use Siyuan MCP Timeline in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add yangtaihong59/siyuan-plugins-mcp-sisyphus --skill siyuan-mcp-timeline -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/siyuan-mcp-timeline, .gemini/skills/siyuan-mcp-timeline, .github/skills/siyuan-mcp-timeline and .opencode/skills/siyuan-mcp-timeline in your project.

What does Siyuan MCP Timeline need to run?

SKILL.md names no scripts, command-line tools or credentials: Siyuan MCP Timeline is instructions for the agent only.

Does Siyuan MCP Timeline access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Siyuan MCP Timeline safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Siyuan MCP Timeline use?

Siyuan MCP Timeline is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Siyuan MCP Timeline use?

About 647 tokens (SKILL.md is roughly 2.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Siyuan MCP Timeline?

Skills that share tags, products or a category with Siyuan MCP Timeline: MCP Server Builder (anthropics/skills, 180k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), MCP Integration for Plugins (anthropics/claude-plugins-official, 38k stars) and Crush Configuration (charmbracelet/crush, 29k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Siyuan MCP Timeline?

yangtaihong59 (a GitHub user) maintains it in yangtaihong59/siyuan-plugins-mcp-sisyphus, which has 116 GitHub stars. The repository holds 30 skills in this directory. The repository was last updated on October 8, 2026.

Source: yangtaihong59/siyuan-plugins-mcp-sisyphus on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.