即刻App年轻人的同好社区
下载
App内打开
Kostja
6天前
那么又有朋友要问了,如果不想用别人的,想享受下从零开始创建skills的乐趣该怎么操作呢,这是我的best practices

【用 Agent 生成符合规范的 Skills,再用 meta-skill 生成更多 skills】

Agent Skills 有明确规范,不是随便一个 markdown 就能叫 skill。权威规范在 [Agent Skills Specification](agentskills.io),由 Anthropic 发起并维护,是跨平台的开放标准。skill 必须包含规定的 frontmatter(name、description 等)和目录结构,才能被 Cursor、Claude Code 等正确识别和加载。meta-skill 指的是「生成 skills 的 skill」——它本身是符合规范的 skill,但作用是指导 Agent 按规范写出新的 skill。

查找 meta-skill 建议去 [skills.sh](skills.sh):这是 Agent Skills 的发现和安装目录,安装量决定排名。skills.sh 上排名靠前的发布者(Vercel Labs、Anthropic、Microsoft)发布的 skills 普遍符合规范,可作为参考。

生成 skill 的 meta-skill 里:

1️⃣skill-creator(anthropics/skills)是 Anthropic 官方的,50K+ 安装,支持 Create、Eval、Improve、Benchmark 四种模式,覆盖从意图到测试、迭代、描述优化的全流程,安装命令是 `npx skills add anthropics/skills --skill skill-creator`。

2️⃣skill-creator(vercel-labs/agent-browser)是 Vercel Labs 的版本,侧重「如何写好 skill」的指导:强调 Concise is Key、Set Appropriate Degrees of Freedom、Progressive Disclosure,提供 skill 结构说明、scripts/references/assets 使用建议、渐进式披露模式,以及六步创建流程(理解用例 → 规划资源 → init_skill.py 初始化 → 编辑 → package_skill.py 打包 → 迭代),安装命令是 `npx skills add github.com --skill skill-creator`。

两者都是 meta-skill,Anthropic 版偏全流程与评估,Vercel Labs 版偏写作原则与打包流程。

3️⃣Cursor 自带的 create-skill 也是 meta-skill,路径在 ~/.cursor/skills-cursor/create-skill/,在 Agent 里输入 /create-skill 或说「创建 skill」就会触发,会问用途、位置、触发场景、领域知识等,再帮你搭结构、写 SKILL.md。

4️⃣SKILLS_GUIDE.md 是我写的规范文档,基于 Agent Skills Specification、skills.sh 和 Vercel skills CLI,与官方 spec 的区别在于:spec 定义格式和结构,SKILLS_GUIDE 侧重”如何写“

description 怎么写(WHAT + WHEN、第三人称、触发关键词)
正文如何组织(步骤、边界情况、示例、Related Skills)
如何渐进式披露(主文件 <500 行、细节放 references)
命名约定(topic-action、category-subcategory-specific)
质量检查清单

写 skill 时 @ 一下,AI 会按这套写作规范来,而不是只满足格式要求。

5️⃣规范参考
Agent Skills Specification:agentskills.io(权威规范,由 Anthropic 维护)。
skills.sh 标杆:Vercel Labs、Anthropic、Microsoft 发布的 skills 可作为规范参考。

Kostja: 以前写给人看的文章,现在写给Agent看的Skills 把上次自己的网站的构建方式https://m.okjike.com/originalPosts/698b1cc39f3cd84f65af9191?s=ewoidSI6ICI2NTA1MmJkYTQwYTRjNTU5MjMxYjZlOTAiCn0=泛化成更通用的网站构建模版了👇 给 Cursor / Claude 装了个 SEO + 页面技能包,用下来挺香的 最近在用 Cursor 做站,发现让 AI 写 landing page、做 sitemap、写定价页的时候,经常要自己先讲一堆背景和规则,不然输出就很泛、很水。 后来就做了这个技能包:把 SEO 和页面相关的东西拆成 64 个「技能」,让 AI 按任务自动选对应的 skill,输出会专业很多。 ——— 先说 SEO 这块 Skills 本质就是给 AI 看的 markdown,每个 skill 里有一套流程和最佳实践,AI 会按这个来干活,而不是自己瞎猜。 推荐顺序是:Technical → On-Page → Content → Off-Page,一层层往上做。 技术 SEO:robots.txt、sitemap、canonical、索引、爬取、IndexNow 这些。比如你说「帮我配置 robots.txt,加上 AI 爬虫规则」「帮我优化 sitemap」「修复 canonical 和重复内容」「解决 Search Console 的索引问题」「给 Bing 上 IndexNow」,AI 会按对应 skill 来,不会乱来。 On-Page:meta 标签、标题、描述、hreflang、结构化数据、内链、URL 结构、标题层级(H1–H6)。你说「优化 meta 和标题」「加 schema 做 rich results」「审计内链结构」「修复 H1–H6 结构」,AI 会按 skill 里的最佳实践来。 Content:关键词研究、搜索意图、内容策略、pillar 和 cluster 页。Off-Page:外链建设、反链分析、有毒链接。从技术到内容到外链,一条龙。 ——— 再说页面创建 24 种页面类型都拆好了,按用途分:品牌、SEO、营销、合规、工具。 品牌:首页、关于、联系 SEO:功能页、词汇表、博客、资源、FAQ、API 介绍页 营销:定价、产品、服务、分类页、客户案例、联盟计划、媒体 Kit 合规:隐私、条款、Cookie、退款、配送 工具:404、招聘 每种页面都有对应的 skill,结构、话术、转化点都会更靠谱。比如你说「帮我写个定价页」「写个 About 页」「做个高转化的 FAQ」「写个联盟计划落地页」「写个 API 介绍页」,AI 会按对应 skill 来写。 还有 Components:导航、footer、hero、TOC、logo、trust badges、testimonials、CTA、newsletter 表单。你说「设计一个带 SEO 的导航」「优化 footer」「设计 hero 区域」,AI 会按 skill 来。 ——— Project Context:让输出更贴合你的项目 README 里有一句:Without context, AI outputs stay generic。所以项目里带了一个 product-marketing-context.md 模板,填好之后 AI 会按你的产品来写,而不是通用话术。 模板里主要这几块: 产品概览:一句话描述、品类、商业模式、定价 定位陈述:For [谁] who [需求],our [产品] is a [品类] that [价值],Unlike [竞品],we [差异] because [理由] 价值主张:核心卖点、关键信息、数据/案例 目标用户:谁、行业、要解决的问题、痛点、购买动机 现有网站:URL、技术栈、当前状态、核心页面 关键词:主词、次词、长尾、搜索意图 竞品:直接竞品、替代方案、差异化、可打的缺口 品牌调性:语气、用词偏好、要避免的词 建议先填 1、2、4、8 这几块,后面有数据再补 5、6、7。模板要定期更新,过期的 context 会让输出变差。 装好 skills 之后,把模板拷到 .cursor/product-marketing-context.md(Claude Code 用 .claude/),AI 会自动读,不用每次在对话里重复说。 ——— 怎么装 一行命令: npx skills add kostja94/marketing-skills 装完直接用,不用额外配置。想只装某几个 skill 也行: npx skills add kostja94/marketing-skills --skill seo-technical-robots pages-pricing 想看有哪些 skill: npx skills add kostja94/marketing-skills --list 模板可以这样拿: curl -o .cursor/product-marketing-context.md https://raw.githubusercontent.com/kostja94/marketing-skills/main/templates/product-marketing-context.md ——— 用下来啥感觉 以前让 AI 写 landing page,经常要自己补「要有 hero、social proof、objection handling」这些。现在直接说「帮我写个定价页」,它会按 skill 里的结构来,省不少口舌。 SEO 也是,以前要自己讲「sitemap 要这样那样」「canonical 要这样处理」,现在说「帮我优化 sitemap」「修复 canonical」,AI 会按 skill 里的最佳实践来,少踩很多坑。 填了 Project Context 之后,定价页、About 页、FAQ 这些会带上你的产品名、定位、竞品差异,而不是泛泛的模板话,差别挺明显的。 支持 Cursor、Claude Code 等,MIT 开源。如果你也在用 AI 做站、做 SEO,可以试试。还顺手做了一个Demo页面:https://alignify.co/skills。 项目在 GitHub,点击链接查看(近期文章就先不写了专攻skills,agent读skills的需求远大于人读文章)

013