Agent skill

Siyuan Sisyphus Timeline

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

CLI-only playbook for SiYuan document timelines with siyuan-sisyphus.

MITAuto-check passed

Install Siyuan Sisyphus Timeline

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

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

GitHub CLI
$ gh skill install yangtaihong59/siyuan-plugins-mcp-sisyphus siyuan-sisyphus-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-sisyphus/siyuan-sisyphus-timeline .claude/skills/siyuan-sisyphus-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-sisyphus-timeline
GitHub stars
116
Token cost
~684 tokens
SKILL.md length
244 words
Files
2
Skills in repo
30
Repo updated
First seen
Licence
MIT

At a glance

CLI-only playbook for SiYuan document timelines with siyuan-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 Sisyphus Timeline is an agent skill from yangtaihong59/siyuan-plugins-mcp-sisyphus. CLI-only playbook for SiYuan document timelines with siyuan-sisyphus. 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 680 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

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-sisyphus-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 (its code samples are bash).

    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 Sisyphus Timeline loads about 684 tokens when it runs. Until then it costs about 59 tokens; SKILL.md has 244 words of instructions outside code blocks.

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

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). 244 words, ~684 tokens.

Download SKILL.mdSave it as .claude/skills/siyuan-sisyphus-timeline/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
siyuan-sisyphus-timeline
description
CLI-only playbook for SiYuan document timelines with siyuan-sisyphus. 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 the CLI

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:

bash
siyuan-sisyphus timeline list-nodes --scope 'document' --document-id '<doc-id>' --page '1' --page-size '50' --json
bash
siyuan-sisyphus timeline create-node --name 'Before revision' --scope 'document' --document-id '<doc-id>' --json

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

bash
siyuan-sisyphus timeline compare-node --document-id '<doc-id>' --tag '<timeline-tag>' --page '1' --page-size '20' --no-include-unchanged --json

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-sisyphus help timeline rollback-document and ask the user to enable it when appropriate.

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

bash
siyuan-sisyphus timeline rollback-block --document-id '<doc-id>' --tag '<timeline-tag>' --change-key '<fresh-change-key>' --json
bash
siyuan-sisyphus timeline rollback-document --document-id '<doc-id>' --tag '<timeline-tag>' --json
bash
siyuan-sisyphus timeline delete-node --tag '<timeline-tag>' --document-id '<doc-id>' --json

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-sisyphus/siyuan-sisyphus-timeline of yangtaihong59/siyuan-plugins-mcp-sisyphus.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit d2ad534

Compare with similar skills

Siyuan Sisyphus 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 Sisyphus Timeline compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Siyuan Sisyphus Timeline this skillyangtaihong59/siyuan-plugins-mcp-sisyphus116—~684Automated safety check: PassMIT
Project Timeline Reportthedotmack/claude-mem99k—~3.1kAutomated safety check: PassApache-2.0
GSAP Timelinegreensock/gsap-skills16k3 repos~1.1kAutomated safety check: PassMIT
CLI Anything SiyuanHKUDS/CLI-Anything52k—~875Automated safety check: PassApache-2.0
ML Adoption Playbookaffaan-m/ECC277k1 repos~975Automated safety check: PassMIT
Onboarding Playbooksickn33/agentic-awesome-skills47k1 repos~3.1kAutomated safety check: PassMIT

Similar skills

  • Project Timeline Report

    thedotmack/claude-mem

    Writes a narrative Journey Into report on a project's whole development history, built from the timeline that claude-mem has recorded.

    99k GitHub stars~3.1k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • GSAP Timeline

    greensock/gsap-skills

    Teaches the GSAP timeline API for sequencing animations: gsap.timeline(), the position parameter, labels, defaults, nesting and playback control.

    16k GitHub starsUsed in 3 repos~1.1k tokens
    Frontend & DesignAuto-check passed
  • CLI Anything Siyuan

    HKUDS/CLI-Anything

    SiYuan (思源笔记) CLI — manage notebooks, documents, blocks, and search your knowledge base from the terminal.

    52k GitHub stars~875 tokensUpdated 19 days ago
    Knowledge ManagementAuto-check passed
  • End-to-end methodology for AI agents and software engineers to add machine learning algorithms to existing non-ML codebases.

    277k GitHub starsUsed in 1 repo~975 tokens
    Data & AnalyticsAuto-check passed
  • Onboarding Playbook

    sickn33/agentic-awesome-skills

    Onboarding checklist: step, phase and order, department, owner, linked SOP and required flag.

    47k GitHub starsUsed in 1 repo~3.1k tokens
    Business, Finance & HRAuto-check passed
  • Implementing Soar Playbook With Palo Alto Xsoar

    mukul975/Anthropic-Cybersecurity-Skills

    Build automated incident response playbooks in Cortex XSOAR (Demisto) using its YAML playbook structure, integration commands, and task types to orchestrate phishing, malware, account-compromise…

    34k GitHub stars~2.4k tokensUpdated 1 mo ago
    DevOps & CloudAuto-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

Questions about Siyuan Sisyphus Timeline

What does Siyuan Sisyphus Timeline do?

CLI-only playbook for SiYuan document timelines with siyuan-sisyphus. Siyuan Sisyphus Timeline is an agent skill from yangtaihong59/siyuan-plugins-mcp-sisyphus. CLI-only playbook for SiYuan document timelines with siyuan-sisyphus.

When should I use Siyuan Sisyphus Timeline?

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

How do I install Siyuan Sisyphus Timeline in Claude Code?

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

How do I install Siyuan Sisyphus Timeline in Codex?

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

Can I use Siyuan Sisyphus 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-sisyphus-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-sisyphus-timeline, .gemini/skills/siyuan-sisyphus-timeline, .github/skills/siyuan-sisyphus-timeline and .opencode/skills/siyuan-sisyphus-timeline in your project.

What does Siyuan Sisyphus Timeline need to run?

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

Does Siyuan Sisyphus 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 Sisyphus 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 Sisyphus Timeline use?

Siyuan Sisyphus 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 Sisyphus Timeline use?

About 684 tokens (SKILL.md is roughly 2.7k 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 Sisyphus Timeline?

Skills that share tags, products or a category with Siyuan Sisyphus Timeline: Project Timeline Report (thedotmack/claude-mem, 99k stars), GSAP Timeline (greensock/gsap-skills, 16k stars), CLI Anything Siyuan (HKUDS/CLI-Anything, 52k stars) and ML Adoption Playbook (affaan-m/ECC, 277k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Siyuan Sisyphus 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.