oil-skill-creator
创建、评审、整改和发布 Skill,并规划免费版与付费版、收款交付和更新机制。用户想从零创建 Skill、评审现有 Skill、检查它是否真正有用、修复触发或执行流程,改善首次使用、稳定性、Token 开销、文件分层、弱模型可读性与跨平台兼容性,或者想为 Skill 收费时使用。不要用于执行目标 Skill 负责的实际任务,也不要因为普通的编码、设计或写作请求触发。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/oil-oil--oil-skill-creator)HTML
<a href="/listings/oil-oil--oil-skill-creator"><img src="/api/listings/oil-oil--oil-skill-creator/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
让 Agent 安装
复制下面的仓库地址,告诉你正在使用的 Agent:“请帮我安装这个 Skill。”
https://github.com/oil-oil/oil-skill-creator
使用命令安装
npx skills add oil-oil/oil-skill-creator
运行要求
- Python 3.10+。核心脚本只用标准库,不需要安装依赖、密钥或初始化配置。下文的 `<python>` 在 macOS 和 Linux 通常是 `python3`,Windows 通常是 `py -3`。 - 命令安装需要 `npx`。Node.js 只是安装工具的依赖,核心流程不需要它。 - 可选的凭据输入页需要 Node.js 22.18+。
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 125 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ---
- name: oil-skill-creator
- description: 创建、评审、整改和发布 Skill,并规划免费版与付费版、收款交付和更新机制。用户想从零创建 Skill、评审现有 Skill、检查它是否真正有用、修复触发或执行流程,改善首次使用、稳定性、Token 开销、文件分层、弱模型可读性与跨平台兼容性,或者想为 Skill 收费时使用。不要用于执行目标 Skill 负责的实际任务,也不要因为普通的编码、设计或写作请求触发。
- license: MIT
- compatibility: 核心脚本只使用 Python 3 标准库;可选凭据输入页需要 Node.js 22.18+ 和系统凭据服务,已验证 macOS,Windows 与 Linux 待实机验证;独立效果评估需要隔离执行能力。
- metadata:
- version: "1.1.0"
- ---
- # oil-skill-creator
- 把 Skill 当作需要长期维护的工具。先确认它解决了重复问题,再让它容易开始、稳定执行、能够验证,并如实说明兼容范围。不要把一次任务的提示词包装成 Skill。
- ## 先选择模式
- | 模式 | 适用情况 | 路径 | 默认停止点 |
- | --- | --- | --- | --- |
- | 创建 | 还没有 Skill | 产品定义 → 最小骨架与评估 → 基线 → 实现与对照 → 按需发布 | 交付可用 Skill |
- | Review | 用户只要求评审、审计或找问题 | 读取 → 需求适用表 → 静态检查 → 流程检查 → 报告 | 交付报告后停止 |
- | 整改 | 已有 Skill,用户要求修复或优化 | 读取 → 需求适用表 → 静态检查 → 按需保存快照 → 局部修改 → 复验 | 问题修复且无回归 |
- | 商业化 | 想为 Skill 收费,或评审已收费的 Skill | 能否收费 → 分界 → 引流与落地页 → 收款 → 交付与更新 | 交付方案或改好的 Skill |
- Review 只读:不修改文件、不创建快照、不打包。用户看完报告再授权整改时,从整改路径重新开始。整改不用脚手架重建已有目录,只在用户要求交付发布包时打包。
- ## 开始前
- 已有 Skill 时,先完整读取 `SKILL.md`,再只读取当前模式和问题需要的资源。已有信息不要再问。只有目标或交付物不清楚、需要新增权限或服务、可能覆盖内容,或者主观方向会改变结果时才询问,并把问题一次问完。
- 分工如下:
- - Agent 判断价值、边界、架构、例外和主观质量。
- - 程序执行确定、重复、可验证、失败敏感的步骤。
- - 隔离执行者运行触发测试和效果对照。它不继承作者的工作上下文,只拿到本次请求和指定 Skill,通常是子 Agent。
- - 人判断审美、文案和整体体验。
- 下文的 `<python>` 指已确认版本不低于 3.10 的 Python 解释器:macOS 和 Linux 通常是 `python3`,Windows 通常是 `py -3`。不要假设 `python` 命令一定存在。
- ## 创建路径
- 先读 [产品设计](references/product-design.md),确认问题值得做,并明确用户、当前做法、预期改善、输入、输出、边界、风险和任务类型。一次性需求、普通 Agent 已能稳定完成,或者说不清使用后会改善什么时,不要强行创建。
- 需要脚手架时先预览最小骨架,确认后去掉 `--dry-run` 再运行一次;骨架只确定目录和元数据,不先写长说明:
- ```text
- <python> <oil-skill-creator>/scripts/scaffold_skill.py <skill-name> --output-root <目录> --description <描述> --public --dry-run
- ```
- 只用 `--components` 添加当前确实需要的目录,例如 `--components scripts,tests`,不为示例完整而创建空资源。需要版本号时加 `--version 0.1.0`。
- 再读 [评估规范](references/evaluation.md),准备至少 3 条真实评估并固定模型和执行者,先运行 `without_skill` 基线,再开始大量编写:
- ```text
- <python> <oil-skill-creator>/scripts/prepare_evaluation.py <skill-path> --mode create --iteration 1 --model <模型> --executor <隔离执行者> --allow-missing-skill
- ```
- `--allow-missing-skill` 只在目录还只有 evals 时使用;已有最小骨架可省略。基线完成后按“设计和编写”实现最小候选,沿用同一 `run_plan.json` 运行 `with_skill`,聚合并检查结果,再运行程序校验。
- ## Review 与整改路径
- 先读 [Review 与整改规范](references/review-and-remediation.md),按其中的检查顺序执行。三个节点不能跳过:
- - 运行校验器之前先建需求适用表,批量评审时逐个 Skill 登记。需要用户输入 Key 的 Skill,第一次 Review 就核对凭据入口,这一项最容易漏。
- - 校验器只确认结构问题。Skill 是否有用、流程是否合理、兼容性是否属实,要另外检查。
- - 按 P0、P1、P2 报告。Review 交付报告后停止。
- 整改第一次编辑前判断是否需要旧版快照:要让隔离执行者运行旧版做前后对照、用户要求保留独立基线,或旧版无法从 Git 等可靠来源恢复时,运行 `<python> <oil-skill-creator>/scripts/snapshot_skill.py <skill-path>`;其他整改不建快照,直接局部修改并复验。
- ## 商业化路径
- 先读 [商业化](references/monetization.md),按其中顺序推进:先回答“能不能收费”的四个问题,答不上就停在免费版并说明原因;能收费时再依次规划分界、引流与落地页、收款渠道、交付与更新。评审已收费的 Skill 时只做其中的“商业化体检”,按 Review 的规则只读交付。
- ## 设计和编写
- 核心规则:
- - 触发信息只放在 frontmatter `description`:做什么、什么时候用、哪些相似请求不该触发、与其他 Skill 怎么分工。先讲任务和产物,不用模型、服务商或宿主的名字代替功能介绍。正文不重复触发规则。
- - 默认宿主中立:正式指令、参考资料、README、目录名和示例使用“Agent、宿主、能力、隔离执行者”等通用名称。确实依赖某个宿主时,专用适配器与通用流程分开,并在兼容性中写明。
- - 登录、密钥、系统安装、覆盖、删除和外部写入先获得授权。密钥值不进 JSON、Skill 文件、日志或 Agent 上下文。
- - 重复运行初始化或迁移不能破坏已有配置或产生重复结果。失败时保留可用的中间产物,说明停在哪一步、怎么恢复、还有哪些必做步骤没执行。
- - 正文写目标、判断原则、主流程、必要分支和停止条件,不穷举情境。一步只表达一个主要动作,分支紧邻对应步骤,术语保持一致。有限、稳定、可验证的分支交给程序;依赖语义的选择留给 Agent。
- - 只写能用于同类任务的规则、程序和回归测试。具体任务、个人目录、单次候选、Review 记录和修改历史不进 Skill。
- - 不得包含与 description 不一致的隐藏行为、误导能力、越权访问或数据外传。兼容性只声明实际实现或真实验证过的范围。
- 按问题读取参考资料:
- | 要解决的问题 | 参考 |
- | --- | --- |
- | 首次使用、配置、确认操作、失败恢复;阶段完成后提示下一步;大型产物分段产出或可复用操作页面 | [产品设计](references/product-design.md) |
- | 批量、破坏性、复杂校验或高代价操作 | [计划、校验与执行](references/plan-validate-execute.md) |
- | 宿主依赖、平台差异、普通配置与凭据存储 | [兼容性](references/compatibility.md) |
- | 本机需要输入 API Key 等单行凭据,且没有现成安全入口 | [凭据输入页](references/credential-ui.md),用安装脚本接入随附组件,不为每个 Skill 重新生成页面 |
- | 拆分文件、篇幅、目录导航、Token 开销、弱模型可读性 | [信息架构](references/information-architecture.md) |
- | 触发准确性、效果对照、迭代与停止 | [评估规范](references/evaluation.md) |
- | README、安装入口、发布门槛、打包、密钥筛查 | [GitHub 发布](references/publishing.md) |
- | 版本号设置、升版、标签 | [版本管理](references/versioning.md) |
- | 收费、免费版与付费版、收款、交付、更新提示 | [商业化](references/monetization.md) |
- ## 程序校验
- 开发过程中运行 `<python> <oil-skill-creator>/scripts/validate_skill.py <skill-path>`。公开发布或整改完成前加上严格选项:
- ```text
- <python> <oil-skill-creator>/scripts/validate_skill.py <skill-path> --public --strict --weak-model --universal
- ```
- `--weak-model` 使用更严格的结构限制,`--universal` 检查是否写死了宿主品牌或专属路径;只有产品明确依赖某个宿主时才省略 `--universal`,并在兼容性中说明原因。校验通过只说明程序能确认的问题没有出现,不说明 Skill 有用。
- ## 效果评估
- 用户要求证明效果、整改带来静态检查确认不了的重大行为变化,或者正式发布需要效果证据时,按 [评估规范](references/evaluation.md) 用程序准备目录、运行、聚合并生成评审页。创建模式与普通 Agent 对照,整改模式与写入前的快照对照。目标明确的小范围修正,用静态校验和针对性回归即可。
- 把候选结果、证据和对比报告交给用户,收到反馈前不再修改 Skill。没有隔离执行能力时,说明评估受限,不宣称已完成独立对照。效果不好时先查明原因,不直接追加规则。
- ## 兼容与发布
- 发布前读 [兼容性](references/compatibility.md) 和 [GitHub 发布](references/publishing.md),按其中的门槛检查并打包。README 面向使用者,说明价值、安装、配置、兼容范围、数据边界和输出,不复制 Agent 的执行步骤。版本号只记在源 Skill 的 `metadata.version`,按 [版本管理](references/versioning.md) 设置和升版。
- ## 完成标准
- - 创建:价值成立,主流程可执行,静态校验通过,已说明效果证据与未验证项。
- - Review:结论有证据,缺陷与取舍分开,给出按优先级排列的最小整改方案,没有修改文件或外部状态。
- - 整改:需求适用表逐项有实现和验证证据,凭据项覆盖页面、保存、恢复和实际业务读取;P0、P1 已处理或由用户明确接受;相关回归测试通过,没有覆盖无关内容;做了前后效果对照的,快照和对照证据完整。
- - 商业化:先给出能否收费的结论;规划或改动覆盖分界、引流、收款、交付和更新,没有遗漏的半截流程。
- 交付时只报告文件路径、主要能力、程序与测试结果、已确认的兼容范围、效果证据和剩余风险。不复述整个 Skill,也不把执行过程写回正式文件。
README.md · README · 173 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <p align="center">
- <img src="./assets/readme/hero.png" width="100%" alt="oil-skill-creator:像做产品一样写 Skill">
- </p>
- 创建、评审和改进 Skill,检查功能边界、首次配置、执行稳定性、兼容性与发布交付。
- > 静态校验通过,只能证明已知结构没有问题,不能证明一个 Skill 真的有用。
- ## 三种使用模式
- | 模式 | 什么时候使用 | 默认结果 |
- | --- | --- | --- |
- | 创建 | 从零设计一个可重复使用的 Skill | 可执行、可验证的 Skill |
- | Review | 只想知道现有 Skill 哪里有问题 | 按 P0、P1、P2 排列的只读报告 |
- | 整改 | 已经确认需要修复或优化 | 按需保留基线、局部修改并完成复验 |
- Review 不修改任何文件。整改时只有需要前后效果对照,才先保存旧版快照。
- ## 安装
- ### 让 Agent 安装
- 复制下面的仓库地址,告诉你正在使用的 Agent:“请帮我安装这个 Skill。”
- ```text
- https://github.com/oil-oil/oil-skill-creator
- ```
- ### 使用命令安装
- ```shell
- npx skills add oil-oil/oil-skill-creator
- ```
- ### 运行要求
- - Python 3.10+。核心脚本只用标准库,不需要安装依赖、密钥或初始化配置。下文的 `<python>` 在 macOS 和 Linux 通常是 `python3`,Windows 通常是 `py -3`。
- - 命令安装需要 `npx`。Node.js 只是安装工具的依赖,核心流程不需要它。
- - 可选的凭据输入页需要 Node.js 22.18+。
- ## 开始使用
- 直接用自然语言说明目标和写入权限:
- ```text
- 用 oil-skill-creator 创建一个可公开发布的 Skill。
- ```
- ```text
- 只 Review 这个 Skill,按优先级给出证据,不要修改文件。
- ```
- ```text
- 整改这个现有 Skill;如果需要前后效果对照,先保留旧版基线,再修复和复验。
- ```
- ```text
- 验证新版是否比普通 Agent 或旧版更有效。
- ```
- 已有文件里写清楚的用户、输入、输出或平台限制,不会再问你。只有缺少的决定会改变结果、需要新权限或可能覆盖内容时,才会一次问完。
- ## 它重点检查什么
- ### 值不值得做
- 先确认它解决的是重复问题,并且相比普通 Agent 有看得到的改善。一次性任务、简单提醒或普通 Agent 已经做得稳定的工作,不会被强行包装成 Skill。
- ### 触发边界清不清楚
- description 写清该接哪些请求、不该接哪些相似请求。需要时用固定的正反向测试集实测触发准确率,不凭关键词或直觉判断。
- ### Agent 和程序分工是否合理
- 语义、策略、例外和主观质量交给 Agent 或你来判断;结构、格式、统计、组装和打包这类确定步骤交给程序。这样既减少遗漏,也不会把主观问题硬编码成一棵越长越大的规则树。
- ### 首次使用顺不顺
- 能自动发现、风险低、可撤销的准备工作直接完成,登录、密钥、安装和覆盖先问你。失败后保留可用的中间结果,并说明怎么恢复。
- ### 大型产物和复杂配置
- 产物容易写成难以维护的巨型单文件时,检查能否按稳定边界拆开、单独验证和局部重做,再由脚本组装;不按固定行数机械拆分。复杂配置或反复预览,用读取 manifest 的固定页面代替每次临时生成界面。
- ### 密钥输入
- 目标 Skill 需要在本机输入 API Key 时,可以装上随附的[凭据输入页](references/credential-ui.md):一个页面填 1 到 16 个 Key,密钥存进系统凭据库(macOS 钥匙串、Windows 凭据管理器或 Linux Secret Service),不经过聊天,也不写进配置文件。已有安全入口时优先复用;OAuth、CI 和远程服务器另按实际需求设计。
- ### 想为 Skill 收费
- 先判断值不值得收费,再规划免费版和付费版怎么分、怎样从 GitHub 和落地页引流、怎么收款和交付、更新怎么提示才不打扰用户也不像恶意软件。这些来自一套真实运行的付费 Skill 链路,见[商业化](references/monetization.md)。想看实际效果,可以参考 [ui.oiloil.org](https://ui.oiloil.org) 的产品页和账户页,以及开源命令行工具 [oil-cli](https://github.com/oil-oil/oil-cli)。
- ### 弱模型能否看懂、Token 花在哪
- 检查入口、模式、术语、分支位置和资源读取时机。主文件只保留主流程,阶段细节按需读取,同一规则只写在一处。
- ## 稳定工具
- | 工具 | 用途 |
- | --- | --- |
- | `scaffold_skill.py` | 预览并创建最小 Skill 骨架,拒绝覆盖已有目录 |
- | `install_credential_ui.py` | 向现有 Skill 安装凭据输入页,生成非敏感声明并保护已有修改 |
- | `validate_skill.py` | 检查结构、链接、重复、个人路径、明文凭据、弱模型风险和宿主中立 |
- | `review_requirements.py` | Review 时收集凭据和生成工具线索,供需求适用表逐项核对 |
- | `version_skill.py` | 预览或写入 `metadata.version` 的初始版本与升版 |
- | `snapshot_skill.py` | 在需要效果对照时保存不可覆盖的旧版基线 |
- | `prepare_evaluation.py` | 创建固定的新版、普通 Agent 或旧版对照目录 |
- | `aggregate_evaluation.py` | 聚合执行结果、耗时和检查数据 |
- | `generate_review.py` | 生成不自动打开浏览器的本地静态评审页 |
- | `score_triggers.py` | 统计正向、反向和保留集上的触发表现 |
- | `package_skill.py` | 生成内容稳定、默认不覆盖的 `.skill` 发布包 |
- 查看任一工具的参数:
- ```text
- <python> scripts/validate_skill.py --help
- ```
- ## 效果评估
- 创建模式先准备至少 3 条真实评估并运行“普通 Agent”基线,再编写最小 Skill 和对照;整改需要证明效果时,比较当前版本和写入前快照。程序负责准备固定目录、检查数据格式和聚合结果,子 Agent 等隔离执行环境分别运行两边,审美、文案和整体体验由人来判断。
- 每轮固定一个模型和执行者;需要验证多个模型时使用不同的 `iteration-N`,不混合汇总。目标目录还只有 `evals/evals.json` 时,create 模式可加 `--allow-missing-skill`,候选完成后沿用同一计划。
- ```text
- <python> scripts/prepare_evaluation.py <skill-path> --mode create --iteration 1 --model <模型> --executor <隔离执行者> --allow-missing-skill
- <python> scripts/aggregate_evaluation.py <iteration-path>
- <python> scripts/generate_review.py <iteration-path>
- ```
- schema 2 的每次运行还要在对应 `run-N/` 保存 `execution.json`,记录实际 `model`、`executor` 和 `skill_hash`;可用 `snapshot_skill.py <skill-path> --dry-run --json` 获取内容摘要。没有子 Agent 或等价的隔离执行能力时,仍可完成静态 Review、程序测试和作者试跑,但不能宣称已经完成独立对照。
- ## 兼容性
- | 范围 | 当前状态 |
- | --- | --- |
- | Python | 3.10+,核心脚本只使用标准库 |
- | macOS | 已运行自动化测试 |
- | Windows / Linux | 已按标准库和跨平台路径实现,真实平台运行仍待验证 |
- | 无浏览器或 GUI | 核心流程可用;评审页只生成文件,不自动打开 |
- | 无子 Agent | 创建、静态 Review 和程序测试可用;独立效果对照降级 |
- | 离线环境 | 核心脚本只处理本地文件,不联网 |
- | 可选凭据输入页 | Node.js 22.18+;macOS 原生保存与回读已验证,Windows / Linux 待实机验证 |
- 脚本使用 `pathlib` 和 UTF-8,不依赖 bash、PowerShell、Homebrew 或单平台打开命令。兼容性只描述已经实现或验证过的范围。
- ## 数据与安全边界
- - 只处理用户明确指定的本地文件;普通配置与密钥分开保存;
- - 本项目核心流程无需密钥;可选凭据输入页用于目标 Skill,JSON 只保存非敏感声明和凭据引用;
- - 系统凭据库不能单独隔离同一用户下有任意代码执行权限的 Agent;业务读取程序仍须可信,不向上下文回传密钥;
- - 默认拒绝覆盖已有 Skill、快照、评审页、iteration 和发布包;
- - 打包默认排除 Git、虚拟环境、缓存、评估数据和运行 workspace;
- - 不负责执行目标 Skill 的实际业务任务;
- - 不用 AI 自评分数替代视觉、文案等主观评审;
- - Review、反馈、版本差异和单次任务记录不会写入正式 Skill。
- ## 开发与验证
- ```text
- <python> -m unittest discover -s tests -v
- <python> scripts/validate_skill.py . --public --strict --weak-model --universal
- ```
- 测试覆盖文件保护、快照、基础结构、资源链接、敏感信息、宿主中立、内容重复、弱模型结构、效果评估、触发测试、版本管理和可重复打包。
- 凭据输入页另有多 key 存储隔离、并发页面会话和多变量注入测试。[跨平台工作流](.github/workflows/credential-ui.yml) 在推送、PR 或手动触发时测试三种桌面系统与两个 Node.js 版本,使用随机假凭据验证真实系统后端。工作流配置完成不等于三端已经通过,需要以实际运行记录为准。
- 需要继续设计 GitHub 首页时,可以使用 [beautify-github-readme](https://github.com/oil-oil/beautify-github-readme) 调整阅读顺序或制作视觉资源;它不是安装或运行依赖。
- ## 许可证
- [MIT](./LICENSE)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.