OPC Skills 是一套为独立开发者、一人公司设计的 AI Agent 技能集,可扩展 Claude Code、Cursor、Codex 等 16+ 款 AI 编程工具,自动化完成 SEO 优化、需求调研、域名查询、Logo 生成等任务。本教程涵盖所有安装方式与配置细节。


一、安装前准备

1.1 系统要求

  • Node.js 环境(用于运行 npx 命令)
  • 已安装至少一种支持的 AI 编程工具(Claude Code、Cursor、Windsurf 等)
  • 网络能访问 GitHub 和 npm 仓库

1.2 检查工具兼容性

OPC Skills 通过 npx skills add 可安装到 16+ 款 AI 工具,包括:

工具 Agent 标识 安装路径(项目级)
Claude Code claude .claude/skills/
Cursor cursor .cursor/skills/
GitHub Copilot github-copilot .github/skills/
Codex codex .codex/skills/
Gemini CLI gemini-cli .gemini/skills/
Factory Droid droid .factory/skills/
Windsurf windsurf .windsurf/skills/

二、安装方式

OPC Skills 提供两种安装途径,可任选其一。

方式一:通用 NPX 安装(推荐,支持所有工具)

这是最通用、最灵活的方式,一条命令即可完成安装。

安装所有技能到所有已检测到的 AI 工具

1
npx skills add ReScienceLab/opc-skills --all

该命令会自动检测你电脑上已安装的 AI 编程工具,并将所有 OPC Skills 安装到对应目录。

安装所有技能到指定 AI 工具

1
2
3
4
5
# 仅安装到 Cursor
npx skills add ReScienceLab/opc-skills --skill '*' -a cursor

# 安装到 Claude Code 和 Cursor
npx skills add ReScienceLab/opc-skills --skill '*' -a claude-code -a cursor

安装单个指定技能

1
2
3
4
5
# 只安装 reddit 技能
npx skills add ReScienceLab/opc-skills --skill reddit

# 只安装 requesthunt 技能到 Droid
npx skills add ReScienceLab/opc-skills --skill requesthunt -a droid

全局安装(对本机所有项目生效)

1
npx skills add ReScienceLab/opc-skills --all -g

先查看可用技能列表

1
npx skills add ReScienceLab/opc-skills --list

自动确认安装(适合脚本/CI 环境)

1
npx skills add ReScienceLab/opc-skills --all -y

方式二:Claude Code 插件市场安装

如果你只使用 Claude Code,可通过其内置的插件市场安装。

步骤 1:添加 OPC Skills 市场源

在 Claude Code 的对话界面中执行:

1
/plugin marketplace add ReScienceLab/opc-skills

步骤 2:安装技能

1
2
3
4
5
6
7
# 安装特定技能
/plugin install requesthunt@opc-skills
/plugin install domain-hunter@opc-skills
/plugin install seo-geo@opc-skills

# 查看所有可用技能
/plugin marketplace list opc-skills

三、处理技能依赖关系

部分技能依赖其他技能才能正常工作:

技能 依赖
domain-hunter reddittwitter
logo-creator nanobanana
banner-creator nanobanana

安装时应一并安装依赖:

1
npx skills add ReScienceLab/opc-skills --skill reddit --skill twitter --skill domain-hunter

四、API 密钥配置

部分技能需要配置 API 密钥才能使用:

技能 必需密钥 可选密钥 是否强制
requesthunt REQUESTHUNT_API_KEY
logo-creator GEMINI_API_KEY REMOVE_BG_API_KEYRECRAFT_API_KEY
twitter TWITTERAPI_API_KEY
producthunt PRODUCTHUNT_ACCESS_TOKEN
seo-geo DATAFORSEO_LOGINDATAFORSEO_PASSWORD
domain-hunter
reddit

API 密钥通常通过环境变量配置,具体方式取决于你使用的 AI 工具。


五、验证安装

安装完成后,检查对应目录下是否生成了技能文件夹。

项目级安装检查(在项目根目录执行):

1
2
3
4
5
6
7
8
# 检查 Cursor 技能目录
ls .cursor/skills/

# 检查 Claude Code 技能目录
ls .claude/skills/

# 检查 Factory Droid 技能目录
ls .factory/skills/

全局安装检查(检查用户目录):

1
2
3
# 检查全局技能目录
ls ~/.claude/skills/
ls ~/.cursor/skills/

六、包含的技能清单

OPC Skills 包含以下 10 个技能:

技能名称 功能描述
seo-geo SEO 与 GEO 优化,适配 ChatGPT、Perplexity、Google 等 AI 搜索引擎
requesthunt 从 Reddit、X、GitHub 调研用户需求
domain-hunter 搜索域名、对比注册商价格、查找优惠码
logo-creator AI 生成 Logo,支持裁剪、去背景、导出 SVG
banner-creator 为 GitHub、Twitter、LinkedIn 等生成横幅
nanobanana 使用 Gemini 3 Pro Image 生成图片
reddit 通过公共 JSON API 搜索 Reddit 内容
twitter 通过 twitterapi.io 搜索 X/Twitter 内容
producthunt 搜索 Product Hunt 帖子、话题、用户和收藏
archive 归档会话学习和调试解决方案

七、常见问题

Q1:提示“No skills found”

确保仓库包含有效的 SKILL.md 文件,且文件中包含正确的 namedescription 字段。

Q2:技能在 Agent 中没有加载

  • 检查技能是否安装到了 Agent 对应的正确路径
  • 确认 Agent 是否支持 Agent Skills 标准
  • 检查 SKILL.md 的 YAML 格式是否正确

Q3:权限不足无法安装

确保你对目标目录有写入权限。项目级安装需要项目目录的写入权限,全局安装可能需要管理员权限。


八、进一步资源