Beautiful Article：单文件网页文章编辑器
把多种来源材料编辑成可离线打开、分享和审阅的精美 HTML 文章。
证据显示有明确的文章边界、三次逐项确认、禁止静默替用户决策、Raw 主题令牌约束、离线单文件交付和可选 PDF；因此具备一定的权限与外部影响控制。扣分在于会运行 shell、npm、浏览器及可选抽取工具，脚手架安装未固定版本的 reacticle，且未充分说明 URL/PDF/DOCX 数据流、敏感信息处理、失败回滚和依赖供应链风险。
文档提供了分阶段流程、目录约定、typecheck/build 命令、失败修复规则和无 SubAgent 时的兜底说明，快乐路径较清晰。扣分在于静态审查无法复现关键路径；reacticle 使用 latest，外部工具可选且可用性不确定，异常输入、网络失败、构建失败和提取错误的诊断信息仍不充分。
触发场景、输入类型、输出格式、文章与应用的边界、文章类型和信息保留比例均有较清晰说明，并有中英文文档和目标语言处理规则。扣分在于对运行环境能力、海外 npm/URL 服务可达性、截图/PDF/DOCX 实际支持边界和中文网络环境未充分说明；核心依赖 npm 与可能的远程 URL 获取，存在可达性不确定性。
目录结构、渐进读取指南、安装命令、脚本、主题注册、FAQ、MIT 许可、manifest 版本和发布流程均有记录，维护结构相对完整。扣分在于选定技能本身未给出明确维护负责人、变更日志或更新责任；依赖版本使用 latest，README 展示和文档较长但故障排除与版本稳定性说明不完整。
目标是将多种素材编辑为可离线分享的单文件 HTML 文章，工作流、组件协议、主题和终审节点与该目标一致，理论上能完成核心任务。扣分在于静态材料没有可独立验证的构建产物或第三方执行证据，展示案例主要是作者陈述和外链样例；输出可能仍依赖 Agent 正确实现 React/Reacticle 代码，直接可用性和相对手工编辑的收益未被充分证明。
存在具体 SKILL.md、README、manifest、脚手架模板、package.json、TypeScript 配置、发布工作流和声明的展示案例，具备一定审计材料。扣分在于未提供覆盖关键路径的测试套件或 CI 构建验证，案例与外部链接不能在本次静态审查中独立复现，因此只能给予有限可验证性。
- 运行 URL/PDF/DOCX 抽取和 npm 安装前，应确认素材是否包含敏感信息、网络访问是否获授权，以及依赖版本是否需要锁定。
- reacticle 使用 latest，可能导致同一版本的生成结果或构建行为变化；建议固定版本并保留可回滚的锁文件。
- README 中的案例与离线可用性声明未在本次静态审查中执行验证，不应视为已测试结论。
这个 Skill 能做什么，适合哪些场景？
Beautiful Article 是 Garden Skills 中面向文章制作的编辑工作流技能。它可以处理网页 URL、PDF、DOCX、Markdown、纯文本、截图和粘贴材料，并将内容规划、编辑和设计为单文件 HTML 文章。工作流包含素材抽取、编辑规划、用户确认、首屏制作、完整生成、终审和修复。它专注于文章，不生成后台、表单、dashboard、产品原型或通用 Web App。
读取用户提供的 URL、PDF、DOCX、Markdown、纯文本、截图或粘贴材料；将来源统一整理为 Markdown，并记录抽取不确定项；制定文章类型、结构、主题、版式和配图计划；通过 reacticle 语义组件与受主题约束的 Raw 层生成 React/Vite/TypeScript 文章项目；运行类型检查和构建流程；输出可离线打开和分享的单文件 HTML，并可按用户确认选择导出 PDF；在计划、首屏、完整文章和交付前执行分阶段质检。
- 研究人员把 PDF 或网页资料整理成保留信息完整度较高的长文或研究报告。
- 编辑把 DOCX、Markdown 或采访材料制作成可分享的专题文章、对话稿或复盘文档。
- 技术作者把复杂主题整理成教程、解释文或带表格、代码、公式和 SVG 图解的视觉文章。
- 团队需要把一批原始笔记制作成带目录、封面和统一主题的离线 briefing。
这个 Skill 有哪些优点和局限？
- 支持 URL、PDF、DOCX、Markdown、纯文本、截图和粘贴材料。
- 默认保留完整信息，并提供多种文章类型及对应的信息保留比例。
- 输出单文件 HTML，可离线打开、分享和归档。
- 包含主题、目录、封面、语义组件、Raw 视觉层和分阶段质检流程。
- 支持 Claude Code、Claude.ai、Cursor、Codex CLI、Gemini CLI 和 OpenCode 的仓库级兼容说明。
- 工作流包含多个必须停下确认的检查点，追求快速一次性生成的用户可能觉得流程较长。
- 只面向文章，不适合生成应用、dashboard、后台或产品原型。
- 完整构建依赖 Node.js、npm、Vite、React、TypeScript 和 reacticle 等工具。
- 源材料抽取、URL 访问、PDF/DOCX 处理和可选 PDF 导出可能需要相应的本地文件、网络或浏览器环境。
- 提供的资料未说明独立测试套件或各类输入的覆盖范围。
如何安装这个 Skill？
使用 skills CLI 安装：npx skills add ConardLi/garden-skills -s beautiful-article。也可以克隆仓库后，将 skills/beautiful-article 复制到项目的 .claude/skills/、.agents/skills/ 或其他兼容 Agent Skills 客户端扫描的技能目录。仓库采用 MIT 许可证。
如何使用这个 Skill？
提供一个或多个网页 URL、PDF、DOCX、Markdown、纯文本、截图或粘贴材料，并提出类似“把这篇做成网页文章”或“生成一篇可分享的 HTML 长文”的请求。技能会先判断目标是文章还是应用，再经过计划确认、首屏确认和交付确认；如果没有素材，应先提供素材或大纲。如果目标是应用、后台、表单、dashboard 或通用 Web App，则不属于此技能范围。