关于 tool-positioning-for-repositories
用于围绕实际用户价值改写仓库名称、简介、README 开篇和网站工具卡片的 Skill。它帮助仓库维护者说明工具的用途与入门方式，并避免暗示未经证实的背书。
主要功能
- 01改写仓库简介
- 02将项目定位为可用工具
- 03套用工具卡片和 README 公式
- 04突出用户收益与入门方式
- 05补充准确的来源背景
适用场景
- 01撰写 GitHub About 简介
- 02修改 README 开篇
- 03制作网站工具卡片
- 04明确工具价值和第一步操作
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/tool-positioning-for-repositories确认已加载。
详细介绍
仓库工具定位技能
目的
改写 GitHub 仓库名称、About 描述、README 简介和网站工具卡片，让它们清楚传达对用户的实际价值。
原则
不要将仓库定位为作品集项目，而要将其定位为读者可以使用的工具。
工具卡片公式
Name -> user benefit -> setup path
示例：
AgentDesk - Make any machine ready for human and AI-agent work. Open the repository and follow the setup guide.
README 简介公式
This tool helps you [achieve outcome] by [mechanism]. It is useful when [situation]. Start with [first action].
以效益为重点的描述模式
- “让任何机器都能为……做好准备”
- “将大量 X 转化为可重复的 Y……”
- “将 X 打包一次，即可在任何地方安装。”
- “将杂乱的 Y 转化为可复用的 Z。”
- “为……创建可重复执行的操作系统”
- “自动化从 X 到 Y 的繁琐流程。”
增强可信度
在属实的情况下，补充可信的来源背景：
较弱的表达：
A setup script for my machine.
更好的表达：
A workstation setup system adapted from senior engineering practices and customized for agentic AI workflows.
规则：
- 不要暗示获得官方认可。
- 在准确的情况下，使用“改编自”“受……启发”“基于公开指南”或“借鉴……经验”等表述。
- 将读者获益放在首位。
避免使用
- “这是我的项目。”
- “一个作品集项目……”
- “只是一个小工具……”
- “实验性仓库……”
- “并非玩具项目”这类负面定位。
检查清单
- 读者是否知道可以用它做什么？
- 第一步操作是否一目了然？
- 描述是否强调效益而非实现方式？
- 是否在不虚假暗示认可的前提下增强了可信度？
- 这句介绍是否足够简短，可以放进 GitHub About 栏？
评论
支持 Markdown