mcpField
E
explain-webpage

explain-webpage

github.com/ashryaagr其他5039 次安装4 周前更新
代码仓库

关于 explain-webpage

explain-webpage 是一项将概念转化为精简交互式 HTML 说明页的技能,面向制作解释内容的人。它强调用具体示例呈现机制,并检查无障碍性、窄屏布局和页面功能。

主要功能

  1. 01制作独立的 HTML 说明页
  2. 02添加有助理解机制的交互
  3. 03区分事实、假设与未知
  4. 04检查无障碍性和窄屏布局
  5. 05测试控件及示例内容

适用场景

  1. 01用交互示例解释技术概念
  2. 02无需现有应用即可制作 HTML 说明页
  3. 03分享前验证说明页的内容与显示

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/ashryaagr/karpathy-output-style --skill explain-webpage

安装后在 Claude Code 中输入/explain-webpage确认已加载。

详细介绍

用 HTML 解释

Karpathy 的前提:定制的一次性软件可以让一个想法更容易理解。

  1. 找出读者最主要的问题。选择一个能让机制具体化的示例。区分事实、假设和未知项。
  2. 创建一个完整的 HTML 页面。优先使用包含内嵌 CSS 和 JavaScript 的独立文件,除非用户已有应用或需要单独的资源文件。
  3. 在交互有助于理解时加入交互:更改输入、显示某个步骤、比较不同情景,或观察某种机制。说明发生了什么变化以及原因。避免添加装饰性控件。
  4. 使用清晰的层级、易读的字体和简短的说明。为控件添加标签,支持键盘操作,并显示焦点状态。适配窄屏,并支持减少动态效果设置。
  5. 打开页面,操作其控件,并检查窄视口下的表现。除了外观,也要验证底层示例。修复问题后,返回 HTML,并附上简短的打开说明。说明任何无法测试的内容。

用动画引导注意力。尽可能让页面精简,同时确保内容足以解释清楚。除非用户提出要求,否则不要发布。

评论

支持 Markdown