Index of every page on this site: llms.txt
All skills
cat-xierluo avatar

/svg-article-illustrator

@5fb69a0
Run it yourself

根据文章内容创作动态 SVG 文章配图,以构图、图形关系和状态变化解释内容;默认输出3–5秒原生SMIL动画,静态图仅作为明确例外。支持时间轴编译、布局检查与PNG导出;不用于完整视频制作或自动发布。

Use this Skill: https://skilld.dev/gh/cat-xierluo/legal-skills/svg-article-illustrator

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈74 tokens for metadata: the name and description. ≈1.8k when used: this file. ≈33k more on demand in 20 files.

Description uses 1.6% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈126 characters, or 1.6%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

SVG Article Illustrator

读取全文、调用项目的交付约定,以及 Skill 的画布与样式规则,再做配图。先定阅读任务,再定视觉形态;从参考作品提炼表达方法,示例仅说明方法或技术用法。文章 SVG 插图默认动态:每张图至少安排一组解释对象关系或状态变化的原生 SMIL 动画,动画是交付口径,不是可选加分项。

常规循环时长目标为 3–5 秒,其中 3 秒左右优先用于单一、清楚的状态变化,5 秒是文章插图上限。内容更多时先拆图、删掉无信息动作或提高关键状态密度;不得靠延长周期换取完整。任何 3–5 秒方案都要保留关键结果的可读停留,不能让形成、拆分、替换或接续变成一闪而过。

静态只用于调用方明确要求静态、目标平台拒绝动画,或动画确实无解释增益的总结图。选择静态必须在配图计划和交付说明中逐图写明理由;不得因为关系图、分类图或制作方便而静默降级为静态。

最终交付前用 validate 或 publish 验收,命令默认拒绝没有原生 SMIL、全部轨道恒定或所有变化轨道均可确定永久隐藏的 SVG。只有已记录逐图理由的静态例外才可显式加 --allow-static;不得为通过门禁改写例外理由。Markdown 内联交付也要先把每段 SVG 单独通过该门禁。

工作方法

  1. 内容 → 配图计划:为每张图记录对应段落、读者需要理解的关系/变化、图的作用、插入点、输出模式,以及按画幅档位选定的尺寸与理由。根据同屏关系、文字和运动空间选画幅,按信息增益决定数量,不按标题数或固定张数配图。
  2. 计划 → 视觉表达:用一句话说清读者将看到哪些对象、它们有什么关系或变化,再选择画面形态。在计划中说明关键关系由什么形状、位置或动作呈现,再决定标题、容器和连线;同时记录必须保留的事实与对象辨识细节,见阅读编排和视觉设计。逐图按这段要讲清的内容选画法:可重绘真实页面、为内容设计界面,也可用非界面的图形表达。参考作品不决定整篇的画法。已有插图先按上述方法审旧基线:旧图已讲清内容时沿用,不用“换成动画”或“重新设计”替代比较。沿用表示不重画,不绕过交付门禁;动态旧图按原样验证,静态旧图仍按逐图静态例外记录并显式放行。
  3. 对象/状态 → 时间轴:列出对象、标签、容器、坐标系、初末状态和互斥关系。让运动说明对象如何变化、为何变化;在 3–5 秒内组织需要的变化与可读停留,结合关键状态和过渡共同安排空间与节奏。过程复杂就拆图或压缩无关动作。确认为静态例外时,仍记录该图缺少动效的解释理由。
  4. 骨架 + 时间轴 → SVG:使用唯一 data-cue 定位实际图形;通过 时间轴工具 编译,不手算大量 keyTimes。静态例外直接输出可读 SVG。变换坐标合同和修正示例见 动态规范。
  5. SVG → 实测与整图审阅:运行结构校验;按画布与样式规则检查可见外缘。打开自包含 HTML,在桌面与 375 CSS px 宽度测量真实文字与对象,检查截图。覆盖初态、停留、运动中段、循环末与下一轮;实际播放两个完整周期。按阅读编排审内容理解、观看顺序、最终布局和文字疏密;返修后回查此前反馈是否仍落实,记录具体画面与所见。动画存在、字数减少或无碰撞均不能单独代替这一层;还要说明运动是否让对象关系、结构、数量或因果比基线更容易理解,不能只比较质感或节奏。多图先做一张代表图,比较关键状态能否读清;有旧图时以相同阅读宽度对照。确认表达成立后再扩展,旧图没有改进收益就保留。测量方法及边界见 布局验收。
  6. 实测 → 交付:按调用项目要求内联 SVG、保存文件或插入 PNG;回读实际交付内容,确认动画、ID 引用和文本仍完整。通过 publish 剥离制作标记,保留原生 SMIL;预览 HTML 的 JS 不进入发布 SVG。本地 HTML 片段交接见工具参考。提供源骨架、时间轴和验证记录以便修改。

按需加载

任务 参考
选画幅、安排文字与对象 共享原则
提升设计感、选择构图与图形语言、避免套模板 视觉设计
设计读者观看顺序、动作接续及新旧版本对照 阅读编排
操作演示、机制或状态变化 动态 SVG
编译 JSON、校验与预览 CLI 时间轴工具
DOM 测量、长文本、重叠反馈 布局验收
明确静态例外与静态后备 静态 SVG
需要表现真实操作,或选择用界面呈现状态变化 UI 与微交互
输出 PNG PNG 导出
多图有界委派 并行协作
维护与回归、独立复验 验证设计
借鉴来源与评估边界 来源记录

工具入口

构图确定后,再按时间轴工具选用编译、校验、预览和导出命令。工具示例供查询用法;预览可在浏览器播放、定位时点和运行 window.measureSvgLayout(svg)。

PNG 路径保留 node scripts/svg2png.js input.svg [output.png] [dpi],需要既有 Node.js、Puppeteer和浏览器;缺少时按环境约定准备项目本地依赖,不自动做全局安装。

交付边界

  • XML/时序检查通过仅代表本工具支持的保守 SVG 子集通过;未知语法会拒绝,检查边界见工具参考。
  • 动态交付必须回读每段 SVG 中的 animate / animateTransform;validate / publish 默认拒绝无动画文件。发现仅有装饰性浮动时,先修订时间轴,不得将其称为解释性动态配图。
  • 布局测量基于实际 DOM,可发现边界问题与碰撞候选;不能仅凭字符估宽、一个时点或文字边界交集断言画面正确。容器、互斥状态与有意遮挡都保留可观察证据。
  • 浏览器成功不证明公众号编辑器、保存后预览或手机 WebView 成功。逐环境记录实测时间、入口与结果;未测项写 NOT_VERIFIED。静态 SVG 与 PNG 也要核对实际字体、裁切和发布入口。
  • 默认交回计划、源码和本地验证结果;内容发布、外部上传和安装不包含在本 Skill 的默认动作内。

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning18d4 checks · Risk SAFE
  • Gen Agent Trust Hub18d

    The 'svg-article-illustrator' skill is a comprehensive and security-conscious toolset for generating animated SVG illustrations from article content. It includes a robust validation engine that enforces a strict 'fail-closed' policy on SVG tags and attributes, effectively preventing XXE, malicious scripts, and external data exfiltration. While it includes helper scripts for shell automation and headless browser rendering (Puppeteer), these are well-documented functional components of the illustration workflow. No malicious patterns or security violations were detected.

  • Socket18d

    1 alert: gptAnomaly

  • Snyk18d

    Risk: LOW · No issues

  • Runlayer8mo

    2/10 files flagged

Signed by skilld at 5fb69a0. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 2 weeks ago
homepage
https://github.com/cat-xierluo/legal-skills
author
杨卫薪律师(微信ywxlaw)
version
1.2.4

README badge

README badge for cat-xierluo/legal-skills/svg-article-illustrator