【免费下载链接】SkillsAgent skills for designers and builders using Codex, Claude, Cursor, and other AI coding agents项目地址https://gitcode.com/gh_mirrors/skills48/Skills点击查看免费下载本文围绕 Skills 仓库中article-prompts-to-skills技能的参考文档 example-packages.md 展开它是一份用于校准「从文章/教程/提示词包提取技能」时提取深度与提示词具体性的示例集。在 Codex、Claude、Cursor 等 Agent 环境中当你希望把一篇文章中的多个交互提示词拆解为一个个可独立复用的 AgentSkill 包时本文给出的三类示例独立视觉行为、混合来源、工作流提示词包与五条质量检验标准能帮助你判断「哪些能力值得做成技能」「一个技能包的边界在哪里」「示例提示词该写到多具体」。读完本文你将掌握一套可复制的提取判断方法、三种可直接套用的提示词写作级别以及一条从提取账本到最终验证交付的完整打包路径。1. 示例包在技能化流程中的定位example-packages.md是 SKILL.md 的配套参考文档。主技能定义了一条完整的流水线检查源材料 → 建立提取账本 → 提炼可移植契约 → 打包每个技能 → 编写三种示例提示词 → 构建可运行演示 → 验证 → 只提交任务相关变更。而示例包文档承担的是其中最主观、最容易跑偏的一环——判断一个提示词是否值得独立成技能以及提示词应该写到多具体。文档开篇即给出两条校准准则Use these examples to calibrate extraction depth and prompt specificity. Adapt the structure; do not copy the subjects or visual treatments by default.翻译为实际操作准则就是适配结构而非照抄主题从源文章复用的是行为机制状态转移、输入方式、可访问性契约而不是文章的选题、品牌或视觉风格校准提取深度文档给出的三个示例分别代表三种来源形态帮助你把「哪些提示词必须拆开」「哪些提示词应保持整体」的判断校准到合理粒度校准提示词具体性每个技能包要同时提供 Minimal / Recreate / Remix 三级提示词示例展示了同一机制在不同描述密度下的写法差异。这一原则与 SKILL.md 的顶层思想一致「Preserve the useful behavior, not the source pages brand or layout」保留有用行为而不是源页面的品牌或布局。2. 示例一从一篇文章提取四个独立视觉行为2.1 四行为拆分的判断依据示例一给出了一篇「花卉滚动体验」文章其中包含四个提示词。文档用一张表格给出了「为什么它可以独立成包」的判断逻辑源行为技能包为什么独立成包环境漂移元素Ambient drifting elementsambient-section-particles可复用不依赖滚动或排版由页面进度控制的时间线A timeline controlled by page progressscroll-progress-timeline拥有自己的状态模型和导航行为由滚动擦除的帧序列A frame sequence scrubbed by scrollscroll-scrubbed-visual-sequence拥有独特的资源加载与插值契约随读者滚动逐词揭示Words revealed as the reader scrollsscroll-scrubbed-word-reveal拥有独特的文本切分与可访问性契约这张表的核心判据可以归纳为三个问题脱离原页面的滚动与排版后该行为是否仍然成立ambient-section-particles是容器级粒子氛围与滚动叙事无关故可独立它是否拥有自己的状态模型scroll-progress-timeline需要维护「当前章节」这一状态与导航语义独立于其他滚动特效它是否有独特的契约scroll-scrubbed-visual-sequence依赖帧资源加载与进度插值scroll-scrubbed-word-reveal依赖文本节点切分与行内语义保持二者契约完全不同。这四项技能在当前仓库中均有完整实现可对照阅读以印证「独立契约」的实际含义ambient-section-particles/SKILL.md维护粒子数量、重力、风力、摇摆、回收/沉降等独立配置与滚动无关scroll-progress-timeline/SKILL.md以「步骤中心点之间的归一化进度」驱动进度线并定义aria-currentstep的激活语义scroll-scrubbed-visual-sequence/SKILL.md用「帧序列/视频/canvas 渲染器」与「归一化进度」建立一一映射scroll-scrubbed-word-reveal/SKILL.md通过 TreeWalker 切分文本节点、保留内联语义标签。四个技能包各自拥有独立的SKILL.md、agents/openai.yaml、demo/目录印证了「一能力一技能」的仓库组织方式。2.2 三级提示词校准具体性的标尺示例一紧接着给出同一个技能scroll-progress-timeline的三级提示词这是文档中最具实操参考价值的部分它定义了「提示词具体性」的刻度Minimal最简——只声明目标能力与作用对象Use $scroll-progress-timeline to add a fixed chapter rail that marks the active section and lets keyboard users jump between chapters.Recreate复刻演示——描述完整参考体验、实现契约、交付物与验收项并强调「内容与视觉系统必须原创」Use $scroll-progress-timeline to build a self-contained editorial demo with a vertical progress rail, four anchored chapters, an active indicator derived from document progress, clickable labels, visible focus states, and reduced-motion behavior. Keep the content and visual system original.Remix混搭迁移——改变主题、文案、配色与章节数但保留进度计算、键盘导航、响应式折叠与可访问性语义Use $scroll-progress-timeline to reinterpret the same mechanism for a product release story. Change the copy, palette, chapter count, and rail placement while preserving progress calculation, keyboard navigation, responsive collapse, and accessibility semantics.对照 demo/PROMPT.md 可以看到这一「三级提示词」结构就是仓库内每个技能包demo/PROMPT.md的强制模板### Minimal prompt、### Recreate the demo、### Remix prompt。示例包的意义正在于它用一个真实机制进度时间线示范了同一能力在不同描述密度下的边界——Minimal 只触发能力Recreate 定义验收契约Remix 证明机制可迁移。3. 示例二混合可复用与页面专用提示词的五选二取舍示例二描述了一篇落地页文章其中包含五个提示词磁性按钮、WebGL 主视觉hero、定价网格、创始人引言、品牌页脚。文档的决策清单逐条给出判断createmagnetic-pointer-target——仅当悬停物理与输入降级fallbacks是显式契约时才创建create or updatepointer-reactive-webgl-background——仅当着色器行为、性能限制与降级方案有文档时才创建或更新update an existing pricing-page skill——如果定价网格只是普通信息架构则不新建技能do not create a founder-quote skill——仅凭编辑性文案不足以成技能do not create a branded-footer skill——当提示词大部分是源站特定的布局时不做成技能。文档给出的结论是The correct result may be two skills from five prompts.五个提示词正确结果可能是两个技能。这是对「过度提取」最直接的校准——它明确指出了三类典型的「不提取」情形纯编辑性内容创始人引言只有文案、没有可复用的行为契约源站特定布局品牌页脚行为被品牌结构绑定无法迁移普通信息架构定价网格已有技能契约可以覆盖只需更新而非新建。这一决策与主技能 SKILL.md 中的边界规则一一对应「每个可独立复用的行为创建一个技能」「当已有技能的契约已覆盖该能力时更新它」「跳过不产生可重复方法的装饰性或编辑性碎片」。仓库中确实存在 pricing-page/SKILL.md它正是「普通信息架构归入既有技能」这一原则的落地产物。实践要点遇到混合来源的提示词包时先建立提取账本源提示词 → 可复用能力 → 保留/删除 → 技能名 → 演示证据再逐条套用上述决策宁缺毋滥——技能包的价值在于可移植契约而不是提示词数量。4. 示例三工作流提示词包的整体打包示例三的源材料不是一组并列行为而是一个工作流教程把一张参考页转换为多个截图支撑的交互提示词。文档给出的核心判断是Keep the workflow together when capture, evidence mapping, prompt writing, and article insertion form one verified handoff.当「截图采集 → 证据映射 → 提示词编写 → 文章插入」构成一次可验证的交付verified handoff时应把整个工作流打包为一个工作流技能workflow skill而不是拆成「拍截图」「写提示词」「更新文章」三个独立技能——除非这些步骤被独立请求且在流程之外同样有用。工作流技能的包结构要求如下一个聚焦的SKILL.mddemo/input.md——包含一份虚构的源数据包demo/expected-output.md——展示提取账本与交付内容demo/index.html——可视化工作流但不假装运行外部系统三级示例提示词最简使用、精确复刻、主题混搭。这一结构在本文关联的技能包自身中就有完整范本demo/input.md 提供了一份虚构的编辑类文章指针镜头、阅读导轨、归档过滤器三个提示词demo/expected-output.md 给出了对应的提取账本、技能清单与 pointer-lens 的三级提示词demo/index.html 则以证据优先的工作台形式可视化整个映射过程。判断工作流是否「整体成包」的准则该工作流是否只有作为整体才有价值。若各步骤共享同一套中间产物如提取账本并形成单一可验证交付就应整体打包只有当某一步骤可被独立调用且独立产生价值时才考虑拆分。5. 质量测试技能包可移植性的五项检验文档以「质量测试」收尾定义了一个技能包可移植portable的判定标准。当另一个 Agent不依赖源文章能够完成以下五件事时该包才算合格从描述中识别触发条件identify the trigger from the description——说明SKILL.md的 description 必须包含足够的触发短语在看不到源文章的情况下将方法应用于新主题apply the method to a new subject without seeing the source article——说明契约必须是自包含的仅凭指令与示例复现关键行为reproduce the important behavior from the instructions and examples——说明示例提示词与演示缺一不可依据显式验收检查验证结果verify the result from explicit acceptance checks——说明SKILL.md必须写入可执行的验收项区分机制与演示的艺术方向distinguish the mechanism from the demos art direction——说明机制必须与主题、配色、视觉系统解耦。对照 SKILL.md 的「可移植契约」定义可以更完整地理解这五项检验的落点保留行为与状态转移、数据模型与参数默认值、时序/缓动/间距/响应式规则、可访问性与 reduced-motion 与键盘行为、性能约束与失败模式、能证明结果的验收检查移除品牌名、营销文案与专有内容、与能力无关的页面布局、硬编码的调色板/资源/选择器、不影响结果的偶然实现选择。五项检验的前四项分别对应契约的四个组成部分触发词、自包含性、示例证据、验收项第五项则对应「保留/移除」清单中的核心取舍——这也是示例一表格中每一行「为什么独立」的根本判据机制契约清晰艺术方向可替换。6. 把示例包方法落地到完整打包流程示例包只是校准工具真正的交付要回到主技能的完整流程。将文档的三类示例与 SKILL.md 的流程合并可以得到一份可直接执行的落地清单先检查后提取读完源文章后运行git status --short保留无关工作搜索现有SKILL.md查重若源材料是裸 HTML 且尚无提示词先调用$html-to-interaction-prompts见 html-to-interaction-prompts/SKILL.md建立提取账本六列表格源提示词 / 可复用能力 / 保留 / 删除 / 技能名 / 演示证据逐条对照示例二的决策清单提炼可移植契约按「保留/移除」清单操作参考示例一的四行为拆分判断打包每个技能目录结构遵循 SKILL.md 定义的契约——SKILL.md命令式语气、frontmatter 只含name和description、agents/openai.yaml显示名、25–64 字符的短描述、显式调用$skill-name的默认提示词、按需的references/、assets/或scripts/、demo/index.htmlPROMPT.mdpreview.jpg工作流技能另加input.md与expected-output.md编写三级示例提示词严格按示例一与 demo/PROMPT.md 的 Minimal / Recreate / Remix 模板用演示而非装饰证明demo 必须首屏展示核心机制、使用真实内容、支持 390px–1440px、语义化 HTML、可见焦点状态、动画提供 reduced-motion 行为、依赖本地化见 SKILL.md验证完整包运行quick_validate.py与仓库演示校验在浏览器中实测主交互、键盘焦点与 reduced-motion 路径确认控制台无错误再以共享尺寸捕获真实浏览器预览并重建图库最后扫描变更文件中的密钥与私有路径只提交任务本身仅暂存新技能目录与其所需的图库文件提交前审查git diff --cached --stat报告源到技能的映射、示例提示词与演示路径、验证证据、提交哈希以及未纳入提交的既有脏文件。在整个过程中示例包文档始终是校准器遇到「要不要拆」「提示词写到多细」「算不算可移植」的疑问时回到示例一的三张表格、示例二的五条决策与质量测试的五项检验即可。7. 常见失败模式自查结合主技能与示例包打包时最常见的偏离可以归纳为六类可作为文章落地前的自查项页面克隆Page clone复制源页面布局而非提取机制——违反示例一「适配结构而非照抄主题」巨型技能Mega-skill把多个独立提示词合并进一个含糊技能——违反示例二「五个提示词、两个技能」的粒度判断微型碎片Micro-fragments把每个句子都做成技能而无独立可复用行为——违反示例二对引言/页脚的「不提取」决策主题锁定Theme lock-in硬编码源文章调色板、资源与文案——违反可移植契约的「移除」清单与质量测试第 5 项仅提示词包Prompt-only package缺少可运行的 demo 与浏览器预览——违反质量测试第 3 项仅凭指令与示例即可复现虚假证据Fake proof未实际演练就声称完成了交互验证——违反 SKILL.md 的「不得仅凭静态文件检查声称验证」。完成上述自查后一套文章提示词就能被稳定地转化为符合仓库规范、可被其他 Agent 直接调用的独立技能包——这正是 example-packages.md 作为校准参考的最终价值。赞分享【免费下载链接】SkillsAgent skills for designers and builders using Codex, Claude, Cursor, and other AI coding agents项目地址https://gitcode.com/gh_mirrors/skills48/Skills点击查看免费下载相关推荐Skills 仓库实战用 article-prompts-to-skills 将文章提示词包转换为可复用的 Agent SkillSkills 仓库实战用 article prompts to skills 将文章提示词包转换为可复用的 Agent Skill 本指南围绕 SkillsSkills 仓库实战把文章提示词转换成可复用 AgentSkill 包article-prompts-to-skills 全流程解析Skills 仓库实战把文章提示词转换成可复用 AgentSkill 包article prompts to skills 全流程解析 本文以 Skill终极指南用NetDXF掌握DWG文件处理的艺术在当今数字化设计领域CAD工程师和.NET开发者经常面临一个共同的挑战如何在应用程序中高效处理DWG文件格式。传统的解决方案要么过于复杂要么功能有限让开人工智能AI AgentAgent 框架后端多智能体RAG工具调用Agent 记忆Agent 工作流AI 评测MCP 服务MCP Clients语音上一篇Two.js 精灵系统Two.Sprite实战指南基于纹理图集的静态贴图与逐帧动画下一篇Dopamine-roothide 隐藏越狱完整指南3 步让 iOS 15 设备跑通创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考