Skip to content
oil-oilPublic

About

制作便于滚动阅读与分享的单页 HTML 文档,统一文字、图解、界面示例与插图风格。

Resources

Stars

21 stars

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

Repository files navigation

oil-html:把功能介绍、产品展示和方案说明制作成可分享的单页 HTML 文档

一个只在明确点名时启用的 HTML 分享文档 Skill。

Single-page HTML · Built-in design system · Explicit opt-in · MIT

它可以完成什么

制作便于滚动阅读与分享的单页 HTML 文档,统一文字、图解、界面示例与插图风格。

内容 结果
产品或功能材料 整理成 4–5 个以内的阅读模块
过程和操作 使用聊天、终端、平台卡片或步骤条展示
视觉系统 白底黑字、微弱网格和暖黄强调
交付文件 完整的单页 HTML,可直接打开和分享

适用范围

适合:

  • 功能介绍
  • Skill 演示
  • 产品展示
  • 方案说明

不适合:

  • API 参考和内部技术文档
  • 需要实时数据与表单提交的产品界面
  • 16:9 翻页演示或 PowerPoint

安装

Claude Code

npx skills add oil-oil/oil-html

Codex

npx skills add oil-oil/oil-html

使用

这个 Skill 不会因为普通的 HTML 或落地页任务自动触发。请明确点名:

使用 $oil-html,把这份产品材料整理成一份可分享的单页 HTML 文档。

也可以直接限定内容:

使用 $oil-html,制作一份 3 屏以内的功能介绍,重点展示操作流程和最终结果。

设计约定

  • 正文不小于 14px,默认使用 16px 和 1.85 行高。
  • 一份文档控制在 2–3 屏、4–5 个模块以内。
  • 黑、白、灰为主,暖黄作为常驻强调色。
  • 能用拟真 UI 展示的内容,不再重复编写说明。
  • 插画只解释抽象概念,不替代真实产品内容。
  • 最终交付完整 HTML,样式直接内联。

仓库内容

oil-html/
├── SKILL.md
├── oil-html.css
├── agents/
│   └── openai.yaml
└── assets/readme/
    └── hero.svg

SKILL.md 定义内容和制作规则,oil-html.css 提供页面、排版、卡片、聊天、平台、终端、步骤和插画容器等基础样式。

License

MIT

配置、依赖与使用边界

HTML/CSS 直接使用 bundled oil-html.css,不需要专用账号;文案依赖 oil-tone,插图按需使用 oil-visual。生图费用由相应工具决定。

仅明确点名时触发。默认图片内联为单文件;可替换素材模式须一起交付图片目录。拟真 UI 是演示,不能冒充真实业绩截图。

使用示例:

用 oil-html 做一份介绍我的字幕工具的单页分享文档。

GitHub 安装

把 仓库地址 交给 Agent,要求按 README 安装;也可运行:

npx skills add oil-oil/oil-html

安装后由宿主重新加载 Skill。

About

制作便于滚动阅读与分享的单页 HTML 文档,统一文字、图解、界面示例与插图风格。

Resources

Stars

21 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages