1. 从“marketingskills”说起一个被低估的营销技能库到底解决什么问题第一次看到marketingskills这个词很多人会以为它只是某个营销课程的文件夹名或者一份整理好的话术模板。但如果你最近在折腾 Claude Code、AI agents 这类工具就会意识到它其实指向一个更具体的东西一套可以被 AI 代理直接调用的营销技能集合覆盖 SEO、CRO、内容策略、落地页诊断、关键词聚类等高频场景。我最初接触这个概念是因为手上同时压着三个独立站的优化任务。传统做法是打开 Ahrefs 拉关键词、用 Screaming Frog 爬站、再手动整理成表格一套流程下来大半天就没了。后来我把这些重复动作拆成结构化的技能描述交给 Claude Code 去调度执行效率直接翻了几倍。marketingskills的核心价值就在这里——它把营销人员脑子里的“经验判断”翻译成 AI 能理解、能复用的指令单元。这篇文章适合三类人看一是正在用 Claude Code 做自动化工作流的开发者二是想用 AI 提效但不知道从哪下手的营销从业者三是手里有独立站、想系统化做 SEO 和 CRO 但预算有限的个人站长。我会把技能库的设计思路、每个技能模块的拆解方式、Claude Code 的接入配置、以及实际跑起来会踩的坑全部摊开讲清楚。读完你至少能自己搭一套可用的营销技能调度流程而不是停留在“听说过 AI 能写文案”的阶段。需要先说明一点marketingskills本身不是一个官方产品名它更像一个约定俗成的叫法指的是围绕营销场景组织起来的一组技能定义文件。你可以把它理解成一个“技能菜单”Claude Code 是那个“厨师”菜单写得越清楚厨师做出来的菜越接近你想要的味道。2. 技能库的整体设计与拆解思路2.1 为什么要把营销动作拆成“技能”而不是“提示词”大多数人用 AI 做营销习惯写一大段提示词比如“帮我分析这个页面的 SEO 问题并给出优化建议”。这种写法的问题在于每次都要重新描述背景输出格式不稳定而且没法复用。你今天让它分析落地页明天让它分析博客文章它给出的结构可能完全不一样。技能化的思路完全不同。一个技能文件本质上是一份带元数据的说明书里面写清楚这个技能叫什么、什么时候触发、需要哪些输入、按什么步骤执行、输出什么格式。Claude Code 读取这些技能后会根据你的实际请求自动匹配对应的技能来执行。我举个具体例子。同样是“分析页面”我会拆成三个独立技能seo-page-audit输入 URL输出标题标签、meta 描述、H 标签结构、内链数量、图片 alt 缺失情况cro-landing-review输入 URL 或页面截图输出首屏信息密度、CTA 位置、信任元素、表单字段数content-gap-check输入目标关键词和竞品 URL输出内容覆盖缺口和推荐补充大纲这样拆的好处是每个技能的输入输出都是确定的我可以单独测试、单独迭代。哪个技能输出不准我就改那一个文件不会影响其他流程。2.2 技能文件的目录结构怎么组织我目前的目录结构是这样的你可以直接参考marketingskills/ ├── skills/ │ ├── seo/ │ │ ├── page-audit.md │ │ ├── keyword-cluster.md │ │ └── faq-schema.md │ ├── cro/ │ │ ├── landing-review.md │ │ └── form-optimize.md │ ├── content/ │ │ ├── outline-gen.md │ │ └── gap-check.md │ └── analytics/ │ └── ga4-insight.md ├── config/ │ └── skills.json └── README.md每个.md文件就是一个技能定义。skills.json是索引文件告诉 Claude Code 去哪里找这些技能。这种按领域分目录的方式好处是当技能数量超过二十个以后你还能快速定位到某个具体文件不至于在一堆平铺的文件里翻找。2.3 技能定义的四个必备字段一个能被 Claude Code 稳定调用的技能文件至少包含四个部分。我拿seo/page-audit.md举例说明第一技能名称和触发条件。写在文件头部用 YAML front matter 格式--- name: seo-page-audit description: 对单个页面进行 SEO 基础审计输出结构化问题清单 trigger: 当用户提供 URL 并要求做 SEO 检查、页面诊断、on-page 分析时触发 ---trigger这个字段很关键。Claude Code 会根据它来判断当前对话是否该调用这个技能。写得太窄该触发的时候不触发写得太宽不该触发的时候乱触发。我的经验是把用户可能说的三到五种表达都列进去比如“检查页面 SEO”“看看这个页面有什么问题”“on-page 分析”。第二输入要求。明确告诉 Claude Code 需要什么才能执行## 输入要求 - 必填目标页面完整 URL - 可选目标关键词如未提供则从页面内容自动推断 - 可选竞品 URL用于对比分析第三执行步骤。这是技能的核心把审计过程拆成有序步骤## 执行步骤 1. 抓取页面 HTML 源码 2. 提取 title 标签检查长度是否在 50-60 字符之间 3. 提取 meta description检查长度是否在 120-158 字符之间 4. 统计 H1 数量确认有且仅有一个 5. 检查 H2-H6 层级是否连续是否存在跳级 6. 统计内链和外链数量标记 nofollow 链接 7. 检查所有 img 标签的 alt 属性 8. 检测页面是否包含 FAQ 结构化数据 9. 汇总问题并按优先级排序第四输出格式。规定输出结构保证每次结果一致## 输出格式 ### 页面基础信息 - URL: - 标题标签: - Meta 描述: ### 问题清单 | 优先级 | 问题类型 | 具体描述 | 修复建议 | |--------|----------|----------|----------| | 高 | ... | ... | ... |这四个字段写清楚一个技能才算真正可用。我见过很多人只写执行步骤不写触发条件和输出格式结果就是每次调用都要手动指定技能名输出还得自己整理完全失去了自动化的意义。2.4 技能之间的依赖关系怎么处理有些营销任务不是单个技能能完成的。比如“给一个页面做完整优化方案”需要先跑seo-page-audit再跑cro-landing-review最后用content-gap-check补充内容建议。这时候有两种处理方式。一种是在技能文件里声明依赖depends_on: - seo-page-audit - cro-landing-review另一种是单独写一个“编排技能”专门负责调度其他技能。我倾向于第二种因为依赖关系写在编排层更清晰单个技能保持纯粹方便单独测试。编排技能大概长这样## 执行步骤 1. 调用 seo-page-audit 技能获取 SEO 问题清单 2. 调用 cro-landing-review 技能获取转化问题清单 3. 将两份清单合并按优先级重新排序 4. 针对高优先级问题调用 content-gap-check 生成内容补充建议 5. 输出综合优化方案这种分层设计的好处是当我想调整某个环节时只需要改对应的单个技能编排逻辑不用动。3. 核心技能模块的细节拆解与实操要点3.1 SEO 页面审计技能从抓取到问题定级seo-page-audit是我用得最频繁的技能也是整个技能库里最值得先做扎实的一个。它的执行逻辑不复杂但有几个细节直接决定输出质量。抓取环节的注意事项。Claude Code 本身不具备直接抓取网页的能力需要借助外部工具。我通常用两种方式一是通过curl命令获取 HTML 源码二是调用已有的爬虫脚本。用curl的好处是快缺点是遇到 JavaScript 渲染的页面就拿不到完整内容。这时候我会在技能里加一个判断## 抓取策略 - 优先使用 curl 获取静态 HTML - 如果页面正文内容少于 500 字符判定为 JS 渲染页面 - 对 JS 渲染页面改用带 headless 浏览器的抓取脚本这个判断逻辑写进技能后Claude Code 会自动根据页面情况切换抓取方式不需要我每次手动指定。标题标签的长度判断。很多人只知道“标题要控制在 60 字符以内”但实际判断时有个坑中文字符和英文字符的宽度不一样。Google 搜索结果页里一个中文字大约占两个英文字符的宽度。所以纯中文标题的合理长度是 30 个汉字左右中英混合的要按像素宽度估算。我在技能里写的是## 标题标签检查规则 - 纯英文50-60 字符 - 纯中文25-30 个汉字 - 中英混合按像素宽度估算中文按 2 倍计算总宽度不超过 120这样判断出来的结果更接近实际搜索结果页的展示效果。H 标签层级检查。常见问题是 H1 缺失、H1 多个、H2 直接跳到 H4。我在技能里加了一条规则如果页面没有 H1但有一个用 CSS 样式模拟的视觉标题要标记为“疑似 H1 缺失”而不是直接判定缺失。因为有些建站工具确实会用 div 加样式来做标题这种情况需要人工确认。FAQ 结构化数据的检测。这是最近热搜里频繁出现的点。FAQ 结构化数据本质上是告诉搜索引擎“这个页面有一组问答内容”让搜索结果里能直接展示这些问题和答案。检测逻辑是在页面源码里搜索application/ldjson脚本块解析 JSON 内容看type是否为FAQPage。如果是再检查mainEntity数组里每个问题的name和acceptedAnswer.text是否完整。我在技能里写了一段检测逻辑的伪代码描述## FAQ 结构化数据检测 1. 提取所有 typeapplication/ldjson 的 script 标签内容 2. 逐个解析 JSON 3. 查找 type 为 FAQPage 的对象 4. 检查 mainEntity 是否为数组且长度大于 0 5. 检查每个元素的 name 和 acceptedAnswer.text 是否非空 6. 如果存在 FAQPage 但字段不完整标记为“结构化数据不完整” 7. 如果不存在 FAQPage但页面有明显问答内容标记为“建议添加 FAQ 结构化数据”这个检测逻辑跑下来基本能覆盖 FAQ 结构化数据的所有常见问题。3.2 CRO 落地页审查技能把“感觉不对”变成可执行清单CRO 比 SEO 更依赖经验判断但这不代表不能结构化。我把落地页审查拆成五个维度每个维度给出具体的检查点和评分标准。首屏信息密度。用户打开页面后不滚动能看到什么我在技能里定义首屏必须包含价值主张、目标受众暗示、核心 CTA 三个元素。缺一个扣 20 分。价值主张的判断标准是能否在 5 秒内让用户明白“这个产品是给谁解决什么问题的”。CTA 位置和数量。一个落地页应该有几个 CTA我的经验是首屏一个主 CTA页面中部一个次级 CTA页面底部一个收尾 CTA。超过三个会分散注意力少于两个会浪费转化机会。技能里的检查逻辑是统计所有按钮和链接中指向转化目标的元素数量和位置分布。信任元素。包括客户 logo、用户评价、数据统计、安全认证标识。我在技能里列了一个清单每出现一种加 10 分满分 40 分。注意用户评价必须是具体的、带名字或头像的泛泛的“很多用户都说好”不算。表单字段数。每增加一个字段转化率大约下降 5%-10%。技能里的规则是如果表单字段超过 5 个标记为“字段过多建议精简”如果超过 8 个标记为“高流失风险”。页面加载速度的间接判断。Claude Code 没法直接测加载速度但可以通过页面源码里的资源数量来间接判断。我在技能里写统计外部 CSS 和 JS 文件数量超过 15 个标记为“资源请求过多”统计图片数量超过 30 张且没有懒加载标记的标记为“图片优化不足”。这套评分体系跑下来一个落地页的 CRO 问题基本能定位到具体位置而不是笼统地说“转化率低”。3.3 内容缺口检查技能竞品分析的结构化做法content-gap-check解决的是“我该写什么内容”这个问题。传统做法是手动看竞品写了什么然后凭感觉判断自己缺什么。技能化的做法是抓取竞品页面提取主题词和自己的内容做对比。具体步骤是这样的## 执行步骤 1. 输入目标关键词和 3-5 个竞品 URL 2. 抓取每个竞品页面的正文内容 3. 提取每篇文章的 H2 和 H3 标题 4. 将所有标题按语义聚类合并相似主题 5. 统计每个主题在竞品中出现的频率 6. 对比自己的内容库标记未覆盖的主题 7. 按出现频率排序输出内容缺口清单这里的关键是语义聚类。不能简单地按关键词匹配因为不同竞品可能用不同说法描述同一个主题。我在技能里加了一步用 Claude Code 自身的语义理解能力把“如何选择关键词”和“关键词研究方法”归为同一类。输出格式我设计成表格主题竞品覆盖数我方是否覆盖建议优先级关键词研究4/5否高内容日历2/5是低这样一眼就能看出该优先补哪些内容。3.4 技能库的版本管理和迭代节奏技能文件不是写完就完了。我给自己定了一个规矩每跑十次某个技能就回顾一次输出质量把不准确的判断规则改掉。比如seo-page-audit最初把“标题超过 60 字符”一律标记为高优先级问题后来发现有些品牌词必须放进去标题就是会超于是改成“超过 70 字符才标记高优先级60-70 之间标记为中优先级”。版本管理我用 Git每次修改技能文件都提交一次commit message 写清楚改了什么规则、为什么改。这样当某个技能输出变差时可以快速回滚到上一个版本。4. Claude Code 接入与技能调用的完整实操4.1 环境准备安装和基础配置Claude Code 的安装方式取决于你的操作系统。macOS 和 Ubuntu 下我都是用命令行安装Windows 下建议用 WSL因为原生 Windows 版本在某些场景下会有兼容性问题。macOS 下的安装步骤# 安装 Claude Code npm install -g anthropic-ai/claude-code # 验证安装 claude --versionUbuntu 下的步骤基本一致但需要先确认 Node.js 版本不低于 18node --version # 如果低于 18先升级 curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt-get install -y nodejs安装完成后第一次运行claude会引导你完成账号配置。如果你在 VS Code 里使用还需要安装 Claude Code 的 VS Code 插件然后在设置里配置好路径。注意如果你在配置过程中遇到“organization has disabled claude subscription access”这类提示通常是账号权限问题需要检查你的订阅状态是否覆盖了 Claude Code 的使用权限。4.2 把 marketingskills 挂载到 Claude CodeClaude Code 支持通过配置文件加载外部技能。我在项目根目录下创建.claude/config.json内容如下{ skills: { directory: ./marketingskills/skills, index: ./marketingskills/config/skills.json } }skills.json里列出所有技能的路径和触发关键词{ skills: [ { name: seo-page-audit, path: seo/page-audit.md, triggers: [SEO检查, 页面诊断, on-page分析] }, { name: cro-landing-review, path: cro/landing-review.md, triggers: [落地页审查, 转化优化, CRO分析] } ] }配置完成后在 Claude Code 里输入“帮我检查一下这个页面的 SEOhttps://example.com”它就会自动匹配到seo-page-audit技能并执行。4.3 调用本地模型运行技能有些朋友可能想用本地模型来跑这些技能比如通过 LM Studio 加载开源模型。Claude Code 支持配置第三方 API 端点你可以在配置里指定本地服务的地址{ api: { baseUrl: http://localhost:1234/v1, model: your-local-model } }需要提醒的是本地模型在语义理解和结构化输出上的稳定性和云端模型有差距。我实测下来技能定义里的步骤越明确、输出格式约束越强本地模型的表现越接近云端模型。如果你的技能文件写得比较模糊本地模型很容易跑偏。4.4 在 VS Code 里调试技能输出VS Code 插件的价值在于你可以直接在编辑器里看到 Claude Code 调用技能的过程和输出结果。我的调试流程是这样的打开 VS Code在侧边栏启动 Claude Code输入测试请求比如“检查 https://example.com 的 SEO”观察它是否触发了正确的技能检查输出格式是否符合技能定义里的要求如果不符合回到技能文件修改对应的步骤或格式描述这个循环跑几轮技能就会越来越稳定。我最初做seo-page-audit的时候改了大概七八次才把输出格式固定下来。4.5 技能调用的参数传递技巧Claude Code 调用技能时参数传递有两种方式。一种是自然语言传递比如“检查这个页面的 SEO目标关键词是‘独立站 SEO’”它会从对话里提取 URL 和关键词。另一种是结构化传递在技能定义里声明参数格式调用时按格式传入。我倾向于混合使用URL 和关键词用自然语言传递因为方便复杂的配置项用结构化传递比如指定输出语言、指定优先级阈值。技能文件里可以这样声明## 可选参数 - output_language: 输出语言默认 zh-CN - priority_threshold: 优先级阈值默认 high - include_schema_check: 是否检查结构化数据默认 true调用时在对话里说明“输出语言用英文只显示高优先级问题”Claude Code 会自动解析并传入对应参数。5. 常见问题与排查技巧实录5.1 技能不触发或触发错误这是最常见的问题。表现是你输入了请求但 Claude Code 没有调用你期望的技能或者调用了错误的技能。排查思路分三步。第一检查trigger字段是否覆盖了你使用的表达方式。如果你说“帮我看看这个页面”但 trigger 里只写了“SEO检查”和“页面诊断”那它可能匹配不到。解决办法是把常见表达都加进去或者用一个更宽泛的触发词。第二检查技能索引文件里的路径是否正确。路径写错的话Claude Code 找不到技能文件自然不会触发。第三检查是否有多个技能的触发条件重叠。比如seo-page-audit和cro-landing-review都包含“页面分析”这个触发词Claude Code 可能会随机选一个。解决办法是让触发词尽量互斥或者在编排技能里显式指定调用顺序。5.2 输出格式不稳定有时候技能触发了但输出格式和定义的不一样。原因通常是技能文件里的输出格式描述不够具体。比如你写“输出问题清单”它可能用表格也可能用列表。解决办法是给出明确的模板## 输出格式 必须使用以下 Markdown 表格格式不得更改列名和顺序 | 优先级 | 问题类型 | 具体描述 | 修复建议 | |--------|----------|----------|----------| | 高 | 标题标签 | 标题超过 70 字符 | 精简至 60 字符以内 |把“必须使用以下格式”和“不得更改”写进去稳定性会明显提升。5.3 抓取失败或内容不完整抓取失败的原因主要有三种目标页面有反爬机制、页面是 JS 渲染的、网络请求超时。对应的处理方式反爬机制在技能里加入请求头模拟或者改用带浏览器环境的抓取方式JS 渲染检测正文长度低于阈值时切换抓取策略超时设置重试次数比如重试 3 次每次间隔 2 秒我在技能里写了一个简单的重试逻辑描述## 抓取重试规则 1. 首次抓取超时时间设为 10 秒 2. 如果失败等待 2 秒后重试 3. 最多重试 3 次 4. 3 次都失败输出“抓取失败请检查 URL 或网络”5.4 常见问题速查表问题现象可能原因排查动作解决方案技能不触发触发词不匹配检查 trigger 字段补充常见表达触发错误技能触发词重叠查看多个技能的 trigger让触发词互斥或加编排层输出格式混乱格式描述不具体检查输出格式部分给出明确模板并加约束语抓取失败反爬/JS渲染/超时查看错误信息加请求头/切换抓取方式/加重试本地模型输出差模型能力不足对比云端模型输出强化技能定义的约束技能执行慢步骤过多或抓取慢查看执行日志拆分技能或优化抓取5.5 几个我踩过的坑第一个坑技能文件写得太长。我最初把seo-page-audit写了两千多字结果 Claude Code 执行时经常漏掉后面的步骤。后来拆成三个子技能每个控制在八百字以内执行完整度明显提升。第二个坑输出格式里用了太多可选字段。比如“如果有竞品数据输出对比表格如果没有输出单页分析”。这种条件分支会让输出变得不可预测。后来我改成两个独立技能一个做单页分析一个做竞品对比各管各的。第三个坑忘了处理空值。比如页面没有 meta description技能里没写这种情况怎么输出结果 Claude Code 有时候输出“无”有时候输出“未找到”有时候直接跳过。后来我在输出格式里明确写了“如字段缺失填写‘未设置’”。6. 技能库的扩展方向与个人经验这套marketingskills跑顺之后我陆续加了几个新技能。一个是ga4-insight输入 GA4 导出的 CSV输出流量异常检测和渠道贡献分析。另一个是ad-copy-gen输入产品卖点和目标受众输出五组不同角度的广告文案。还有一个是competitor-track定期抓取竞品页面对比标题和描述的变化。扩展技能时我遵循一个原则先手动跑通流程再写成技能。如果我自己都没搞清楚某个营销动作的步骤和判断标准写成技能也是白搭。只有当我能在纸上把步骤一二三四写清楚并且知道每一步的输入输出是什么才会动手写技能文件。另外技能库不需要追求大而全。我见过有人一口气写了三十个技能结果常用的就三四个其他的要么触发条件写得太窄用不上要么输出质量不稳定不敢用。我的建议是先把三到五个核心技能做扎实跑上几十次确认稳定后再考虑扩展。最后分享一个实用技巧给每个技能加一个“自检”步骤。在技能定义的最后加一段## 自检 输出前确认 - 所有必填字段是否都有值 - 表格列数是否与模板一致 - 优先级排序是否正确高在前 - 是否有未处理的空值这段自检逻辑写进去之后输出质量明显更稳定。Claude Code 会在输出前自己过一遍把明显的问题修掉。这个技巧我从写第一个技能用到现在基本没翻过车。