Not in the top 1,000 by GitHub stars

ZJUZhiyuCai/vsdx-trace

Trace screenshots and scientific diagrams into high-fidelity, editable VSDX files.

History

Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.

View weekly changes

SKILL.md

Week of Nov 2, 2026 · Line counts unavailable

Before Not checked yet → After Local scripts

First observation → 916409b04d31

No earlier version was observed for comparison.

Compare on GitHub

View on GitHubAdd to my skills

Verified commit 916409b04d314045644ba3c69b956ee003da4a37

11GitHub stars
1star in 7 days
1skill in this repository
1commit in 30 days

Heat

2.6
  • Star growth, last 7 daysNot available
  • Star growth, last 24 hoursNot available
  • Rank movement, last 7 daysNot available
  • Commits, last 30 daysNot available
  • Accounts asking about it through MCP, last 7 daysNot available
  • Hot votes this weekNot available

Heat never changes the order by stars, and sponsorship never touches it. How heat works

Stars over time

Oct 25, 2026Nov 5, 202611

30-day change not yet available: not enough history.

Individual skills in this repository

How it works

vsdx-trace

When your agent uses it

Reconstruct raster references as high-fidelity, independently editable Microsoft Visio VSDX files. Use when a user asks to 复刻、临摹、重绘 a screenshot, paper figure, flowchart, system diagram, or model architecture as editable Visio, especially when iterative visual matching matters. Do not use for ordinary image generation or flat image embedding.

What it loads into context

Frontmatter

133 tokens

Always available to the agent

SKILL.md

3,901 tokens

When the skill is activated

Reference documents

10,370 tokens

Loaded on request

Token counts are estimates. Scripts run separately; they are not counted as reference context.

The playbook

  1. 适用任务
  2. 必需输入
  3. 隐私与复用边界
  4. 不可妥协的交付标准
  5. 核心方法
  6. 标准执行流程
  7. 质量门槛
  8. Gold Standard
  9. 失败模式
  10. 执行环境边界
  11. 进一步参考

Scripts executed separately

  • examples/synthetic_event_routing_case.py
  • scripts/build_from_scene.py
  • scripts/compare_images.py
  • scripts/extract_regions.py
  • scripts/extract_vsdx_scene.py
  • scripts/package_skill.py
  • scripts/prepare_reference.py
  • scripts/privacy_scan.py
  • scripts/render_vsdx.py
  • scripts/validate_vsdx.py
  • scripts/vsdx_builder.py
  • tests/test_pipeline.py

Files

  • .editorconfigasset263 bytes
  • .gitattributesasset101 bytes
  • .github/CODEOWNERSasset95 bytes
  • .github/ISSUE_TEMPLATE/bug_report.ymlasset1,612 bytes
  • .github/ISSUE_TEMPLATE/config.ymlasset400 bytes
  • .github/ISSUE_TEMPLATE/feature_request.ymlasset1,131 bytes
  • .github/PULL_REQUEST_TEMPLATE.mddoc605 bytes
  • .github/dependabot.ymlasset417 bytes
  • .github/workflows/ci.ymlasset804 bytes
  • .github/workflows/codeql.ymlasset447 bytes
  • .github/workflows/release.ymlasset1,010 bytes
  • .gitignoreasset115 bytes
  • CHANGELOG.mddoc1,494 bytes
  • CODE_OF_CONDUCT.mddoc1,357 bytes
  • CONTRIBUTING.mddoc1,938 bytes
  • LICENSEasset1,080 bytes
  • NOTICE.mddoc621 bytes
  • PACKAGE_MANIFEST.jsonasset9,901 bytes
  • PRIVACY_AUDIT.jsonasset3,324 bytes
  • README.mddoc6,673 bytes
  • README.zh-CN.mddoc5,030 bytes
  • SECURITY.mddoc1,006 bytes
  • SKILL.mdcore13,890 bytes
  • SKILL.mdcore13,890 bytes
  • SKILL.mdcore13,890 bytes
  • SKILL.mdcore13,890 bytes
  • SKILL.mdcore13,890 bytes
  • SKILL.mdcore13,890 bytes
  • SKILL.mdcore13,890 bytes
  • SKILL.mdcore13,890 bytes
  • SKILL.mdcore13,890 bytes
  • SKILL.mdcore13,890 bytes
  • SKILL.mdcore13,890 bytes
  • SKILL_TEST_REPORT.jsonasset2,689 bytes
  • SUPPORT.mddoc719 bytes
  • VERSIONasset6 bytes
  • agents/openai.yamlasset294 bytes
  • assets/gold/media/abstract_frame_01.pngasset1,945 bytes
  • assets/gold/media/abstract_frame_02.pngasset1,857 bytes
  • assets/gold/media/abstract_frame_03.pngasset1,782 bytes
  • assets/gold/media/abstract_frame_04.pngasset1,892 bytes
  • assets/gold/media/abstract_frame_05.pngasset1,850 bytes
  • assets/gold/media/abstract_frame_06.pngasset1,890 bytes
  • assets/gold/media/abstract_frame_07.pngasset1,924 bytes
  • assets/gold/media/abstract_frame_08.pngasset1,926 bytes
  • assets/gold/media/abstract_frame_09.pngasset1,862 bytes
  • assets/gold/media/abstract_frame_10.pngasset1,851 bytes
  • assets/gold/media/abstract_frame_11.pngasset1,738 bytes
  • assets/gold/media/abstract_frame_12.pngasset1,889 bytes
  • assets/gold/synthetic_event_routing_editable.vsdxasset243,354 bytes
  • assets/gold/synthetic_event_routing_preview.pngasset238,284 bytes
  • assets/gold/synthetic_event_routing_quality_metrics.jsonasset696 bytes
  • assets/gold/synthetic_event_routing_reference.pngasset174,854 bytes
  • assets/gold/synthetic_event_routing_scene.jsonasset78,599 bytes
  • assets/gold/synthetic_event_routing_shape_inventory.jsonasset351,642 bytes
  • assets/gold/synthetic_event_routing_validation.jsonasset513 bytes
  • assets/marketing/README.mddoc700 bytes
  • assets/marketing/failure-diagnosis-editable-vsdx.pngasset773,952 bytes
  • assets/marketing/failure-diagnosis-reference.pngasset2,744,984 bytes
  • assets/marketing/vsdx-trace-poster-3x4.pngasset763,060 bytes
  • assets/templates/sample-evidence.pngasset1,332 bytes
  • assets/templates/scene-template.jsonasset4,731 bytes
  • docs/RELEASING.mddoc980 bytes
  • evals/evals.jsonasset2,869 bytes
  • examples/README.mddoc1,066 bytes
  • examples/rendered/scene-template-output.pngasset56,382 bytes
  • examples/scene-template-output.manifest.jsonasset372 bytes
  • examples/scene-template-output.validation.jsonasset320 bytes
  • examples/scene-template-output.vsdxasset9,214 bytes
  • examples/synthetic_event_routing_case.pyruns35,232 bytes
  • pyproject.tomlasset216 bytes
  • references/GOLD_STANDARD.mddoc3,233 bytes
  • references/QUALITY_RUBRIC.mddoc2,223 bytes
  • references/RECONSTRUCTION_PLAYBOOK.mddoc6,117 bytes
  • references/SCENE_SCHEMA.mddoc4,324 bytes
  • references/TROUBLESHOOTING.mddoc1,867 bytes
  • references/VSDX_OPENXML_NOTES.mddoc2,791 bytes
  • requirements-dev.txtdoc41 bytes
  • requirements.txtdoc36 bytes
  • scripts/build_from_scene.pyruns199 bytes
  • scripts/compare_images.pyruns8,023 bytes
  • scripts/extract_regions.pyruns4,116 bytes
  • scripts/extract_vsdx_scene.pyruns5,446 bytes
  • scripts/package_skill.pyruns6,111 bytes
  • scripts/prepare_reference.pyruns5,179 bytes
  • scripts/privacy_scan.pyruns7,796 bytes
  • scripts/render_vsdx.pyruns2,606 bytes
  • scripts/validate_vsdx.pyruns10,534 bytes
  • scripts/vsdx_builder.pyruns42,765 bytes
  • tests/test_pipeline.pyruns2,773 bytes
Read SKILL.md

# VSDX Trace

把一张参考图片复刻为高相似度、结构清晰、可逐元素编辑的 `.vsdx`,并通过结构验证和渲染对比反复校准。

## 适用任务

在以下情况启用本 Skill:

- 用户要求“复刻/临摹/重绘成 Visio、VSDX、可编辑流程图”。
- 参考图是论文图、模型架构图、系统框图、流程图、信息图或复杂示意图。
- 用户强调“十分相似、高保真、可编辑、继续重做、无限预算”。
- 仅将整张图片塞入 Visio 不满足要求。

不用于普通图像生成,也不应用文生图模型替代原参考图。
View the complete source on GitHub

Skills included

  • vsdx-trace

Repository facts

License
MIT
Created
Sep 3, 2026
Last pushed
Oct 28, 2026
Forks
0
Open issues
0
Project activity
Active

Before you install

Local scripts

Automated signals, not a guarantee

Checked Nov 6, 2026

Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.

Show 11 notes
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • assets/gold/synthetic_event_routing_shape_inventory.json:10102 Analysis incomplete: regex work limit reached
Show all 69 signals by file

.github/ISSUE_TEMPLATE/config.yml

  • Network accessline 2
    contact_links:   - name: Usage questions and ideas     url: https://github.com/ZJUZhiyuCai/vsdx-trace/discussions
  • Network accessline 3
    - name: Usage questions and ideas     url: https://github.com/ZJUZhiyuCai/vsdx-trace/discussions     about: Ask for help or discuss an idea before turning it into an issue.
  • Network accessline 4
    url: https://github.com/ZJUZhiyuCai/vsdx-trace/discussions
  • Network accessline 5
    about: Ask for help or discuss an idea before turning it into an issue.   - name: Private security report     url: https://github.com/ZJUZhiyuCai/vsdx-trace/security/advisories/new
  • Network accessline 6
    - name: Private security report     url: https://github.com/ZJUZhiyuCai/vsdx-trace/security/advisories/new     about: Report vulnerabilities privately; do not open a public issue.
  • Network accessline 7
    url: https://github.com/ZJUZhiyuCai/vsdx-trace/security/advisories/new

CHANGELOG.md

  • Network accessline 3
    All notable changes are documented here. The project follows [Semantic Versioning](https://semver.org/).
  • Network accessline 4
    [Semantic Versioning](https://semver.org/).
  • Network accessline 41
    [Unreleased]: https://github.com/ZJUZhiyuCai/vsdx-trace/compare/v2.0.0...HEAD
  • Network accessline 42
    [2.0.0]: https://github.com/ZJUZhiyuCai/vsdx-trace/compare/v1.1.0...v2.0.0
  • Network accessline 43
    [1.1.0]: https://github.com/ZJUZhiyuCai/vsdx-trace/releases/tag/v1.1.0

CODE_OF_CONDUCT.md

  • Network accessline 29
    Report conduct concerns privately through the repository's [private advisory channel](https://github.com/ZJUZhiyuCai/vsdx-trace/security/advisories/new)
  • Network accessline 30
    [private advisory channel](https://github.com/ZJUZhiyuCai/vsdx-trace/security/advisories/new)

README.md

  • Network accessline 7
    [![CI](https://github.com/ZJUZhiyuCai/vsdx-trace/actions/workflows/ci.yml/badge.svg)](https://github.com/ZJUZhiyuCai/vsdx-trace/actions/workflows/ci.yml)
  • Network accessline 8
    [![CodeQL](https://github.com/ZJUZhiyuCai/vsdx-trace/actions/workflows/codeql.yml/badge.svg)](https://github.com/ZJUZhiyuCai/vsdx-trace/actions/workflows/codeql.yml)
  • Network accessline 9
    [![Release](https://img.shields.io/github/v/release/ZJUZhiyuCai/vsdx-trace)](https://github.com/ZJUZhiyuCai/vsdx-trace/releases)
  • Network accessline 10
    [![License: MIT](https://img.shields.io/badge/license-MIT-2ea44f)](LICENSE)
  • Network accessline 60
    git clone https://github.com/ZJUZhiyuCai/vsdx-trace.git \
  • Network accessline 175
    - Read [`CONTRIBUTING.md`](CONTRIBUTING.md) before opening a pull request. - Use [GitHub Discussions](https://github.com/ZJUZhiyuCai/vsdx-trace/discussions) for usage questions.
  • Network accessline 176
    - Use [GitHub Discussions](https://github.com/ZJUZhiyuCai/vsdx-trace/discussions) for usage questions.

README.zh-CN.md

  • Network accessline 7
    [![CI](https://github.com/ZJUZhiyuCai/vsdx-trace/actions/workflows/ci.yml/badge.svg)](https://github.com/ZJUZhiyuCai/vsdx-trace/actions/workflows/ci.yml)
  • Network accessline 8
    [![CodeQL](https://github.com/ZJUZhiyuCai/vsdx-trace/actions/workflows/codeql.yml/badge.svg)](https://github.com/ZJUZhiyuCai/vsdx-trace/actions/workflows/codeql.yml)
  • Network accessline 9
    [![Release](https://img.shields.io/github/v/release/ZJUZhiyuCai/vsdx-trace)](https://github.com/ZJUZhiyuCai/vsdx-trace/releases)
  • Network accessline 10
    [![License: MIT](https://img.shields.io/badge/license-MIT-2ea44f)](LICENSE)
  • Network accessline 57
    git clone https://github.com/ZJUZhiyuCai/vsdx-trace.git \
  • Network accessline 131
    - 提交代码前请阅读 [`CONTRIBUTING.md`](CONTRIBUTING.md)。 - 使用问题请前往 [GitHub Discussions](https://github.com/ZJUZhiyuCai/vsdx-trace/discussions)。
  • Network accessline 132
    - 使用问题请前往 [GitHub Discussions](https://github.com/ZJUZhiyuCai/vsdx-trace/discussions)。

SECURITY.md

  • Network accessline 12
    Do not open a public issue for a suspected vulnerability. Use [GitHub private vulnerability reporting](https://github.com/ZJUZhiyuCai/vsdx-trace/security/advisories/new)
  • Network accessline 13
    [GitHub private vulnerability reporting](https://github.com/ZJUZhiyuCai/vsdx-trace/security/advisories/new)

SUPPORT.md

  • Network accessline 6
    - Usage questions and reconstruction advice: [GitHub Discussions](https://github.com/ZJUZhiyuCai/vsdx-trace/discussions)
  • Network accessline 7
    - Reproducible bugs: [bug report](https://github.com/ZJUZhiyuCai/vsdx-trace/issues/new?template=bug_report.yml)
  • Network accessline 8
    - Feature ideas: [feature request](https://github.com/ZJUZhiyuCai/vsdx-trace/issues/new?template=feature_request.yml)

examples/synthetic_event_routing_case.py

  • Executable scriptline 1
    #!/usr/bin/env python3

scripts/build_from_scene.py

  • Executable scriptline 1
    #!/usr/bin/env python3

scripts/compare_images.py

  • Executable scriptline 1
    #!/usr/bin/env python3

scripts/extract_regions.py

  • Executable scriptline 1
    #!/usr/bin/env python3

scripts/extract_vsdx_scene.py

  • Executable scriptline 1
    #!/usr/bin/env python3
  • Network accessline 16
    V = "{http://schemas.microsoft.com/office/visio/2012/main}"
  • Network accessline 17
    R = "{http://schemas.openxmlformats.org/officeDocument/2006/relationships}"
  • Network accessline 18
    PR = "{http://schemas.openxmlformats.org/package/2006/relationships}"

scripts/package_skill.py

  • Executable scriptline 1
    #!/usr/bin/env python3

scripts/prepare_reference.py

  • Executable scriptline 1
    #!/usr/bin/env python3

scripts/privacy_scan.py

  • Executable scriptline 1
    #!/usr/bin/env python3

scripts/render_vsdx.py

  • Executable scriptline 1
    #!/usr/bin/env python3

scripts/validate_vsdx.py

  • Executable scriptline 1
    #!/usr/bin/env python3
  • Network accessline 27
    VISIO_NS = "http://schemas.microsoft.com/office/visio/2012/main"
  • Network accessline 28
    REL_NS = "http://schemas.openxmlformats.org/officeDocument/2006/relationships"
  • Network accessline 29
    PKG_REL_NS = "http://schemas.openxmlformats.org/package/2006/relationships"
  • Network accessline 30
    CT_NS = "http://schemas.openxmlformats.org/package/2006/content-types"
  • Network accessline 98
    relationship.get("Target")                 for relationship in root_rels.xpath("./pr:Relationship", namespaces=NS)                 if relationship.get("Type") == "http://schemas.microsoft.com/visio/2010/relationships/document"
  • Network accessline 99
    for relationship in root_rels.xpath("./pr:Relationship", namespaces=NS)                 if relationship.get("Type") == "http://schemas.microsoft.com/visio/2010/relationships/document"             ]
  • Network accessline 100
    if relationship.get("Type") == "http://schemas.microsoft.com/visio/2010/relationships/document"

scripts/vsdx_builder.py

  • Executable scriptline 1
    #!/usr/bin/env python3
  • Network accessline 31
    VISIO_NS = "http://schemas.microsoft.com/office/visio/2012/main"
  • Network accessline 32
    REL_NS = "http://schemas.openxmlformats.org/officeDocument/2006/relationships"
  • Network accessline 33
    PKG_REL_NS = "http://schemas.openxmlformats.org/package/2006/relationships"
  • Network accessline 34
    CONTENT_TYPE_NS = "http://schemas.openxmlformats.org/package/2006/content-types"
  • Network accessline 35
    IMAGE_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/image"
  • Access to secretsline 263
    [Credential-related source omitted]
  • Network accessline 779
    content_types = f'''<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <Types xmlns="{CONTENT_TYPE_NS}"><Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/><Default Extension="xml" ContentT
  • Network accessline 780
    <Types xmlns="{CONTENT_TYPE_NS}"><Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/><Default Extension="xml" ContentType="application/xml"/><Default Extension="png" ContentType="image/png"/><Ov
  • Network accessline 781
    root_rels = f'''<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="{PKG_REL_NS}"><Relationship Id="rId1" Type="http://schemas.microsoft.com/visio/2010/relationships/document" Target="visio/document.xml"/><Relations
  • Network accessline 782
    document_rels = f'''<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="{PKG_REL_NS}"><Relationship Id="rId1" Type="http://schemas.microsoft.com/visio/2010/relationships/pages" Target="pages/pages.xml"/><Relationshi
  • Network accessline 783
    pages_rels = f'''<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="{PKG_REL_NS}">{''.join(f'<Relationship Id="rId{i+1}" Type="http://schemas.microsoft.com/visio/2010/relationships/page" Target="page{i+1}.xml"/>' f
  • Network accessline 784
    first = self.pages[0]         windows_xml = f'''<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Windows xmlns="{VISIO_NS}" xmlns:r="{REL_NS}" ClientWidth="1000" ClientHeight="700"><Window ID="0" WindowType="Drawing" WindowState="107
  • Network accessline 785
    windows_xml = f'''<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Windows xmlns="{VISIO_NS}" xmlns:r="{REL_NS}" ClientWidth="1000" ClientHeight="700"><Window ID="0" WindowType="Drawing" WindowState="1073741824" WindowLeft="0" Window
  • Network accessline 786
    core_xml = f'''<?xml version="1.0" encoding="UTF-8" standalone="yes"?><cp:coreProperties xmlns:cp="http://schemas.openxmlformats.org/package/2006/metadata/core-properties" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:dcterms="http://pu
  • Network accessline 787
    app_xml = '''<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Properties xmlns="http://schemas.openxmlformats.org/officeDocument/2006/extended-properties" xmlns:vt="http://schemas.openxmlformats.org/officeDocument/2006/docPropsVTypes

tests/test_pipeline.py

  • Executable scriptline 1
    Executable file

How the signals fit together

Facts from a static read of the files at the pinned commit. They describe what the code does, not why.

Some files could not be read; the facts below still hold.

Declared and executed: 8 facts
Signal confidence: 63 facts

and 13 more

Works with

Agent compatibility, from the files in this repository
AgentStatusEvidenceInstall to
Claude CodeCompatibleStandard SKILL.md SKILL.md.claude/skills/<skill-name>/
CodexCompatibleStandard SKILL.md SKILL.md.agents/skills/<skill-name>/
CursorCompatibleStandard SKILL.md SKILL.md.cursor/skills/<skill-name>/
Gemini CLICompatibleStandard SKILL.md SKILL.md.gemini/skills/<skill-name>/
GitHub CopilotCompatibleStandard SKILL.md SKILL.md.github/skills/<skill-name>/
OpenCodeCompatibleStandard SKILL.md SKILL.md.opencode/skills/<skill-name>/
  • Native The repository ships a manifest, folder or frontmatter field for this agent.
  • Compatible A standard SKILL.md that this agent can read.
  • Unknown No evidence either way.

Derived automatically from paths, manifests and frontmatter. Not tested on each agent.