How do I install the Siyuan Sisyphus Tag Flashcard skill?

Run npx skillmds@latest add tomevault-io/siyuan-sisyphus-tag-flashcard in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Siyuan Sisyphus Tag Flashcard safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Siyuan Sisyphus Tag Flashcard?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Siyuan Sisyphus Tag Flashcard free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Siyuan Sisyphus Tag Flashcard?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Siyuan Sisyphus Tag Flashcard by tomevault-io

Name: Siyuan Sisyphus Tag Flashcard
Author: tomevault-io

Siyuan Sisyphus Tag Flashcard

CLI-only playbook for tags and flashcards with `siyuan-sisyphus`. Use for inline tag creation, listing and renaming tags, deck discovery, card creation, due/new card review, and safe card or tag removal. Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

File contents

SiYuan Sisyphus CLI - Tags and Flashcards

Tags are created by writing #tag# into Markdown content. Flashcards should be created with the flashcard tool so SiYuan registers review cards correctly.

Flashcard Structure

SiYuan flashcards commonly use a heading as the prompt and following blocks as the answer:

## Question heading
Answer paragraph.
Another answer paragraph.

Cloze text can be written as ==answer== in content.

Deck Discovery

siyuan-sisyphus flashcard get-decks --json
siyuan-sisyphus flashcard get-cards --deck-id "<deck-id>" --page 1 --page-size 32 --json

Use an empty deck ID only when the command help says cross-deck queries are supported for that action.

Create Cards

First create or identify a heading block:

siyuan-sisyphus block append --parent-id "<doc-id>" --data-type markdown --data "## What is spaced repetition?

Review just before forgetting."
siyuan-sisyphus document get-child-blocks --id "<doc-id>" --json

Then register the heading block as a card:

siyuan-sisyphus flashcard create-card --deck-id "<deck-id>" --block-ids "<heading-block-id>" --json

Avoid using block set-attrs alone for flashcard creation. It can write metadata, but it does not complete the full card registration workflow.

Review Cards

siyuan-sisyphus flashcard list-cards --scope deck --deck-id "<deck-id>" --filter due --json
siyuan-sisyphus flashcard list-cards --scope all --filter new --json
siyuan-sisyphus flashcard review-card --deck-id "<deck-id>" --card-id "<card-id>" --rating 3
siyuan-sisyphus flashcard review-card --deck-id "<deck-id>" --card-id "<card-id>" --skip

Ratings are usually 1 to 4, with higher meaning easier or better recall.

Scopes for Listing Cards

Scope	Required flag
`all`	omit `--deck-id`
`deck`	`--deck-id`
`notebook`	`--notebook`
`tree`	`--root-id`

Remove Cards

Removing cards changes deck membership. Confirm first:

siyuan-sisyphus flashcard remove-card --deck-id "<deck-id>" --block-ids-json '["<block-id>"]'

Pitfalls

create-card validates deck IDs; run get-decks first.
list-cards can post-filter by due/new/old state.
Newly created headings or tags may need a short indexing delay before discovery commands show them.

Source: yangtaihong59/siyuan-plugins-mcp-sisyphus — distributed by TomeVault.

---name: siyuan-sisyphus-tag-flashcarddescription: CLI-only playbook for tags and flashcards with `siyuan-sisyphus`. Use for inline tag creation, listing and renaming tags, deck discovery, card creation, due/new card review, and safe card or tag removal. Use when this capability is needed.---# SiYuan Sisyphus CLI - Tags and FlashcardsTags are created by writing `#tag#` into Markdown content. Flashcards should be created with the `flashcard` tool so SiYuan registers review cards correctly.## TagsCreate tags inline:```bashsiyuan-sisyphus block append --parent-id "<doc-id>" --data-type markdown --data "#project# #urgent#"siyuan-sisyphus block append --parent-id "<doc-id>" --data-type markdown --data "#project/phase1#"```List or filter tags:```bashsiyuan-sisyphus tag listsiyuan-sisyphus tag list --keyword "project" --json```Rename a tag label everywhere:```bashsiyuan-sisyphus tag rename --old-label "old-tag" --new-label "new-tag"```Remove is destructive. Confirm first:```bashsiyuan-sisyphus tag remove --label "tag-to-remove"```Recently written tags may take a short time to appear in tag search.## Flashcard StructureSiYuan flashcards commonly use a heading as the prompt and following blocks as the answer:```markdown## Question headingAnswer paragraph.Another answer paragraph.```Cloze text can be written as `==answer==` in content.## Deck Discovery```bashsiyuan-sisyphus flashcard get-decks --jsonsiyuan-sisyphus flashcard get-cards --deck-id "<deck-id>" --page 1 --page-size 32 --json```Use an empty deck ID only when the command help says cross-deck queries are supported for that action.## Create CardsFirst create or identify a heading block:```bashsiyuan-sisyphus block append --parent-id "<doc-id>" --data-type markdown --data "## What is spaced repetition?Review just before forgetting."siyuan-sisyphus document get-child-blocks --id "<doc-id>" --json```Then register the heading block as a card:```bashsiyuan-sisyphus flashcard create-card --deck-id "<deck-id>" --block-ids "<heading-block-id>" --json```Avoid using `block set-attrs` alone for flashcard creation. It can write metadata, but it does not complete the full card registration workflow.## Review Cards```bashsiyuan-sisyphus flashcard list-cards --scope deck --deck-id "<deck-id>" --filter due --jsonsiyuan-sisyphus flashcard list-cards --scope all --filter new --jsonsiyuan-sisyphus flashcard review-card --deck-id "<deck-id>" --card-id "<card-id>" --rating 3siyuan-sisyphus flashcard review-card --deck-id "<deck-id>" --card-id "<card-id>" --skip```Ratings are usually 1 to 4, with higher meaning easier or better recall.## Scopes for Listing Cards| Scope | Required flag || --- | --- || `all` | omit `--deck-id` || `deck` | `--deck-id` || `notebook` | `--notebook` || `tree` | `--root-id` |## Remove CardsRemoving cards changes deck membership. Confirm first:```bashsiyuan-sisyphus flashcard remove-card --deck-id "<deck-id>" --block-ids-json '["<block-id>"]'```## Pitfalls- `create-card` validates deck IDs; run `get-decks` first.- `list-cards` can post-filter by due/new/old state.- Newly created headings or tags may need a short indexing delay before discovery commands show them.---> Source: [yangtaihong59/siyuan-plugins-mcp-sisyphus](https://github.com/yangtaihong59/siyuan-plugins-mcp-sisyphus) — distributed by [TomeVault](https://tomevault.io).

Frequently asked questions