跳转到主要内容

Snipgrapher

技能 活跃

配置和使用 snipgrapher 生成精美的代码片段图像,包括带有语法高亮、自定义主题、配置文件和样式选项的 PNG、SVG 和 WebP 导出。当用户希望创建代码截图、将代码转换为可共享的图像、为文档或社交帖子生成漂亮的 代码片段、从源文件生成语法高亮图像,或明确提及 snipgrapher 时使用。支持通过 snipgrapher CLI 或 npx 进行单文件渲染、批量处理和监视模式。

目的

允许用户轻松创建用于文档、社交媒体或其他视觉内容需求的、可共享的、带有语法高亮的 代码片段图像。

功能

  • 生成带语法高亮的 代码片段图像
  • 导出为 PNG、SVG 和 WebP 格式
  • 支持自定义主题、配置文件和样式
  • 处理单文件渲染、批量处理和监视模式
  • 使用 snipgrapher CLI 和 npx

使用场景

  • 从源文件生成代码截图
  • 为文档创建可共享的代码片段图像
  • 为社交媒体帖子生成视觉吸引人的代码片段
  • 从代码自动创建批量图像资源

非目标

  • 执行代码分析或 linting
  • 编辑或修改源代码文件
  • 直接与协作平台集成(除了图像生成之外)

工作流

  1. 安装 snipgrapher(如果不存在)
  2. 初始化项目配置(可选,用于重复使用)
  3. 定义所需的配置文件和样式选项
  4. 从源文件渲染代码片段
  5. 验证输出图像的存在和大小

先决条件

  • 已安装 Node.js 和 npm/npx
  • 已安装 snipgrapher CLI 工具

Documentation

  • info:Configuration & parameter reference虽然 SKILL.md 提到了配置和配置文件,但它没有明确记录所有选项、参数或它们的默认值。快速入门显示了基本的 CLI 标志,但缺少全面的参考。

Versioning

  • info:Release Management`pushedAt` 日期表明近期有活动,但在 SKILL.md 或 README 中没有明确的版本信息(如元数据中的 `version` 字段或 GitHub 发布)。通过 `npx` 进行安装意味着使用最新版本。

Code Execution

  • info:Validation该技能调用 snipgrapher CLI。虽然 CLI 本身可能执行验证,但该技能的直接实现没有显示其输入的显式模式验证。
  • warning:Error HandlingSKILL.md 提到了对常见渲染失败的故障排除,但没有详细说明该技能本身如何处理或报告来自 snipgrapher CLI 的错误。快速入门建议验证输出大小,暗示手动错误检查。

Errors

  • warning:Actionable error messagesSKILL.md 提到了对常见渲染失败的故障排除,但没有为特定失败模式或技能本身的补救步骤提供结构化的、可操作的错误消息。快速入门暗示需要手动检查错误。

Practical Utility

  • warning:Edge casesSKILL.md 列出了常见渲染失败(如缺少字体或不支持的语法)的故障排除步骤,但这些是通用的,并未明确记录为具有恢复步骤的结构化失败模式,供技能本身使用。

Safety

  • info:Halt on unexpected stateSKILL.md 提到了验证输出的存在和大小,暗示了对意外状态的检查,但没有明确列出机器可读的前置条件或指示在预状态问题时中止。

安装

npx skills add mcollina/skills

通过 npx 运行 Vercel skills CLI(skills.sh)— 需要本地安装 Node.js,以及至少一个兼容 skills 的智能体(Claude Code、Cursor、Codex 等)。前提是仓库遵循 agentskills.io 格式。

质量评分

79 /100
2 days ago 分析

信任信号

最近提交28 days ago
星标1.8k
许可证MIT
状态
查看源代码