Agent skill

Siyuan Sisyphus Visual Assets

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

CLI-only playbook for semantic SVG charts and figures, approved asset upload, and verified SiYuan block embedding.

MITAuto-check passedAI & LLM Engineering

Install Siyuan Sisyphus Visual Assets

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

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

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

At a glance

CLI-only playbook for semantic SVG charts and figures, approved asset upload, and verified SiYuan block embedding.

  • Works in 4 steps: Read the source image or data and record… → Reuse a matching deterministic… → Check escaped text, viewBox containment,… → …
  • Tasks that involve Embeddings
  • SKILL.md covers Generate and review, Upload and embed and Structural readback
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Siyuan Sisyphus Visual Assets is an agent skill from yangtaihong59/siyuan-plugins-mcp-sisyphus. CLI-only playbook for semantic SVG charts and figures, approved asset upload, and verified SiYuan block embedding.

Its SKILL.md is about 1.2k 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 AI & LLM Engineering, covering Embeddings. The repository describes itself as: 一个用于连接Agent与Siyuan的工具. The licence is MIT.

When your agent uses it

  • Tasks that involve Embeddings

Example prompts

  • “/siyuan-sisyphus-visual-assets”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Read the source image or data and record chart type, series, categories, values, axes, units, grid lines, markers, title, legend…
  2. Reuse a matching deterministic config/builder shape for charts; for figures, decode structure first and choose semantic geometry. If a…
  3. Check escaped text, viewBox containment, text bounds and collisions, line/text clearance, stable stroke width, angle/projection/occlusion…
  4. Semantic correctness comes before pixel similarity. Pixel overlay is optional. A real SiYuan UI review is required for display claims…

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 Visual Assets loads about 1.2k tokens when it runs. Until then it costs about 36 tokens; SKILL.md has 488 words of instructions outside code blocks.

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

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). 488 words, ~1,152 tokens.

Download SKILL.mdSave it as .claude/skills/siyuan-sisyphus-visual-assets/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
siyuan-sisyphus-visual-assets
description
CLI-only playbook for semantic SVG charts and figures, approved asset upload, and verified SiYuan block embedding.

SiYuan Visual Assets with the CLI

Choose the narrowest route: data/config-driven SVG for statistical charts, semantic geometry for explanatory figures, and an existing uploaded asset when vector reconstruction is not appropriate. This scenario does not add a picture-generation tool, renderer, async runner, or platform-specific image utility.

Generate and review

  1. Read the source image or data and record chart type, series, categories, values, axes, units, grid lines, markers, title, legend, geometry, and unresolved readings. Do not invent unclear values.
  2. Reuse a matching deterministic config/builder shape for charts; for figures, decode structure first and choose semantic geometry. If a supported mathematical relation exists, declare and run a validation such as growth or sum; failed validation returns to data review.
  3. Check escaped text, viewBox containment, text bounds and collisions, line/text clearance, stable stroke width, angle/projection/occlusion constraints, and one unique data-chart-key matched to the config registry.
  4. Semantic correctness comes before pixel similarity. Pixel overlay is optional. A real SiYuan UI review is required for display claims: width, responsive behavior, readability, theme contrast, and embed rendering.

Do not make bitmap tracing the default route. Use it only as constrained coordinate assistance; do not force-vectorize photos, maps, comics, or figures whose meaning is the typeface itself. If text, a list, table, or formula states the meaning clearly, prefer native content.

Upload and embed

Resolve the exact notebook/document/block ID, parent-child relation, and insertion position before writing. A title, search hit, or UI position is not write authorization.

bash
siyuan-sisyphus file upload-asset --assets-dir-path '<approved-assets-dir>' --local-file-path '<selected-local-file>' --json

Asset upload reads a user-selected local file and requires explicit approval of both the source file and assets directory. Use the returned asset path as the only subsequent reference; never guess a timestamped filename or preserve a machine-specific path in the Skill.

For an ordinary uploaded image, append one bounded Markdown image block. For inline SVG/HTML, keep all lines in one standalone block; use a complete NodeHTMLBlock DOM update only when an existing block is the exact target. A canonical visual block may be reused elsewhere with a query embed pointing to its stable block ID; do not duplicate the SVG body.

bash
siyuan-sisyphus block append --parent-id '<resolved-parent-id>' --data-type 'markdown' --data '<one-block-markdown-or-inline-html-svg>' --json
bash
siyuan-sisyphus block update --items-json '[{"id":"<existing-leaf-block-id>","dataType":"dom","data":"<complete-node-html-block-dom>"}]' --json
Show full SKILL.md (142 more words)Show less

Structural readback

After each write, read the exact affected ID before any search or UI conclusion:

bash
siyuan-sisyphus block get-kramdown --id '<written-block-id>' --json
bash
siyuan-sisyphus block get-children --id '<resolved-parent-id>' --page '1' --page-size '200' --json
bash
siyuan-sisyphus block dom --id '<written-block-id>' --json
bash
siyuan-sisyphus file get-doc-assets --id '<resolved-document-id>' --asset-type 'all' --json
bash
siyuan-sisyphus search search-assets --query '<asset-filename>' --exts-json '["svg","png"]' --json
bash
siyuan-sisyphus file read-image --id '<resolved-document-id>' --path 'assets/<returned-image-path>' --json

Confirm block type, parent/sibling order, kramdown, DOM attributes, viewBox, escaped text, returned asset path, data-chart-key, canonical embed target, and image/HTML containment. get_doc_assets and search_assets find references or candidates; neither proves rendering. For a bitmap already referenced by the authorized document, a vision-capable client may call read_image for that one image; it still does not replace a real SiYuan UI rendering review. API success, file existence, SQL/index results, or a renderer invocation cannot replace structural readback or real SiYuan UI review.

If a response is lost or the returned asset path is missing/non-unique, stop and inspect the exact target; do not retry an upload or append blindly. Classify geometry WARNs as repaired, justified exemption, or TODO; after repeated unsuccessful adjustments, stop and report instead of relaxing tolerances.

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

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit d2ad534

Compare with similar skills

Siyuan Sisyphus Visual Assets 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 Visual Assets compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Siyuan Sisyphus Visual Assets this skillyangtaihong59/siyuan-plugins-mcp-sisyphus116—~1.2kAutomated safety check: PassMIT
Chroma Vector DatabaseOrchestra-Research/AI-Research-SKILLs13k7 repos~2.3kAutomated safety check: PassMIT
SageMaker Serving Image Selectionhuggingface/skills11k1 repos~4.6kAutomated safety check: PassApache-2.0
Codebase Managementgiancarloerra/SocratiCode3.3k1 repos~1.8kAutomated safety check: PassAGPL-3.0
CLIP Image-Text MatchingOrchestra-Research/AI-Research-SKILLs13k7 repos~1.7kAutomated safety check: PassMIT
Sentence-Transformers Training Routerhuggingface/skills11k1 repos~2.6kAutomated safety check: PassApache-2.0

Similar skills

  • Chroma Vector Database

    Orchestra-Research/AI-Research-SKILLs

    Shows how to store documents and embeddings in Chroma, query them by similarity with metadata filters, and persist them to disk for RAG and semantic search projects.

    13k GitHub starsUsed in 7 repos~2.3k tokens
    AI & LLM EngineeringAuto-check passed
  • Official

    Chooses the right serving container and current image URI for deploying a Hugging Face model to a SageMaker endpoint, preferring Hugging Face images over generic ones.

    11k GitHub starsUsed in 1 repo~4.6k tokens
    AI & LLM EngineeringAuto-check passed
  • Codebase Management

    giancarloerra/SocratiCode

    Set up, index, and manage SocratiCode codebase indexing. An agent skill from giancarloerra/SocratiCode.

    3.3k GitHub starsUsed in 1 repo~1.8k tokens
    AI & LLM EngineeringAuto-check passed
  • CLIP Image-Text Matching

    Orchestra-Research/AI-Research-SKILLs

    Explains OpenAI's CLIP model for zero-shot image classification, image-text similarity, semantic image search and content moderation, with install steps and code patterns.

    13k GitHub starsUsed in 7 repos~1.7k tokens
    AI & LLM EngineeringAuto-check passed
  • Official

    Routes a sentence-transformers training task to the right model type and required reference docs and example scripts, covering bi-encoders, rerankers, sparse and multi-vector models.

    11k GitHub starsUsed in 1 repo~2.6k tokens
    AI & LLM EngineeringAuto-check passed
  • Mashup Mods

    rehan-remade/universal-modder

    Build cross-game mashups and total conversions, the "Minecraft inside Elden Ring" or "skateboarding in MW2" kind.

    6.5k GitHub stars~3.3k tokensUpdated today
    AI & LLM EngineeringAuto-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 Visual Assets

What does Siyuan Sisyphus Visual Assets do?

CLI-only playbook for semantic SVG charts and figures, approved asset upload, and verified SiYuan block embedding. Siyuan Sisyphus Visual Assets is an agent skill from yangtaihong59/siyuan-plugins-mcp-sisyphus. CLI-only playbook for semantic SVG charts and figures, approved asset upload, and verified SiYuan block embedding.

When should I use Siyuan Sisyphus Visual Assets?

Siyuan Sisyphus Visual Assets fits situations like: tasks that involve Embeddings.

How do I install Siyuan Sisyphus Visual Assets in Claude Code?

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

How do I install Siyuan Sisyphus Visual Assets in Codex?

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

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

What does Siyuan Sisyphus Visual Assets need to run?

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

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

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

About 1.2k tokens (SKILL.md is roughly 4.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 Sisyphus Visual Assets?

Skills that share tags, products or a category with Siyuan Sisyphus Visual Assets: Chroma Vector Database (Orchestra-Research/AI-Research-SKILLs, 13k stars), SageMaker Serving Image Selection (huggingface/skills, 11k stars), Codebase Management (giancarloerra/SocratiCode, 3.3k stars) and CLIP Image-Text Matching (Orchestra-Research/AI-Research-SKILLs, 13k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Siyuan Sisyphus Visual Assets?

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.