跳转到主要内容
从命令行直接将Olostep技能文件夹安装到你的AI编码代理中。
  • 技能存放在一个标准的存储位置 (~/.agents/skills)，并通过符号链接或复制到每个代理的技能目录中
  • 所有安装记录在 ~/.agents/.skill-lock.json 的锁文件中
  • 支持Cursor、Claude、Codex、Windsurf、Continue等
此功能可通过 Olostep CLI 使用。

​
技能

olostep add skills 安装所有13个技能。每个技能都有一个 SKILL.md 文件，供你的代理读取，以了解Olostep能做什么以及何时使用。 技能与 MCP服务器 配合使用：MCP服务器为代理提供实时工具，技能则提供知识，以便在何时以及如何使用这些工具。

​
设置

从这里开始——教代理如何配置Olostep MCP服务器。
技能功能
setup配置Olostep MCP服务器，使所有其他技能正常工作

​
核心网页数据

主要的Olostep功能——使用这些功能为你的代理提供实时网页访问。
技能功能
scrape将一个URL转换为干净的markdown / HTML / JSON / 文本
search实时网页搜索——结果、答案和站内URL发现
answers从实时网页数据中获取引用的、结构化的答案
crawl自动爬取整个网站
map发现网站上的每个URL
batch并行抓取多达10,000个URL
extract-schema将页面抓取为符合某个模式的结构化JSON

​
构建与集成

为帮助开发者将Olostep添加到代码库或跟上API变化的代理提供支持。
技能功能
integrate自动将Olostep SDK安装到项目中
docs-to-code抓取API文档并从中编写可用代码
migrate-code阅读迁移指南并更新本地代码

​
研究与调试

为进行研究、做出决策或调试代码错误的代理提供支持。
技能功能
research为决策提供引用的、比较性的网页研究
debug-error在GitHub / SO / 文档中查找错误信息

​
分类

每个技能属于三种类别之一，这些类别映射到 --category 标志：
  • usage — 使用Olostep的功能：scrape、search、answers、crawl、map、batch、extract-schema。
  • build — 将Olostep安装并集成到代码库中：setup（配置MCP服务器）和integrate（将Olostep SDK添加到项目中）。
  • workflow — 使用Olostep生成可交付成果：research、docs-to-code、migrate-code、debug-error。
只安装一个类别： 
olostep add skills --category usage      # 核心网页数据技能
olostep add skills --category build      # 设置+集成技能
olostep add skills --category workflow   # 研究+可交付成果技能

​
托管副本

每个已安装的技能还引用其托管副本，位于 https://www.olostep.com/skills/<name>/SKILL.md — 具有网页访问权限的代理可以获取最新版本（可能包括自安装以来添加的功能），否则会回退到本地副本。在 olostep.com/skills 浏览所有托管技能。

​
安装

npm install -g olostep-cli

# 将所有13个技能安装到每个检测到的代理中
olostep add skills

# 或使用技能子命令（别名）
olostep skills install
或者无需安装CLI： 
npx -y olostep-cli@latest add skills

​
常用用法

# 安装所有技能
olostep skills install

# 刷新/更新到最新版本
olostep skills update

# 查看已安装的技能及其位置
olostep skills list

# 移除所有技能
olostep skills uninstall
过滤安装内容： 
# 仅核心网页数据技能
olostep add skills --category usage

# 仅设置+集成技能
olostep add skills --category build

# 精选
olostep add skills --skill scrape --skill search --skill setup

# 仅特定代理
olostep add skills --agent cursor --agent claude

# 机器可读输出
olostep add skills --json

​
选项参考

选项默认值描述
--login—安装前运行浏览器登录
--source <path>CLI捆绑技能技能源目录
--cli-local-dir <path>CLI/skills用于CLI本地使用的源技能同步目录
--agent <name>—针对特定代理——可重复
--all-agents / --no-all-agents--all-agents针对所有检测到的代理
--global / --no-global--global安装到全局代理技能目录中
--canonical-dir <path>~/.agents/skills标准存储位置
--agent-skills-dir <path>—自定义目标目录（需要 --no-global）
--skill <name>—仅包含此技能——可重复
--exclude <name>—排除此技能——可重复
--category—usage、build或workflow
--overwrite / --no-overwrite--overwrite替换现有安装
--link-mode <auto|symlink|copy>autoauto 首先尝试符号链接，失败则复制
--json—机器可读的JSON输出
验证规则：
  • --link-mode 必须是 auto、symlink 或 copy
  • --agent-skills-dir 需要 --no-global
  • --no-global 需要 --agent-skills-dir
  • 未知代理名称将导致错误
  • --skill / --exclude 后的空技能选择将导致错误

​
JSON输出格式

当传递 --json 时，输出如下： 
{
  "sync": {
    "plugin_source_dir": "/path/to/CLI/skills",
    "cli_local_dir": "/path/to/CLI/skills"
  },
  "selected_skills": ["scrape", "search"],
  "canonical_dir": "~/.agents/skills",
  "lockfile_path": "~/.agents/.skill-lock.json",
  "installed": [
    {
      "skill": "scrape",
      "canonical_path": "~/.agents/skills/olostep-scrape",
      "targets": [
        { "agent": "cursor", "mode": "symlink", "path": "~/.cursor/skills/olostep-scrape" },
        { "agent": "claude", "mode": "symlink", "path": "~/.claude/skills/olostep-scrape" }
      ]
    }
  ]
}

​
支持的代理

代理键
Cursorcursor
Claudeclaude
Codexcodex
Windsurfwindsurf
Continuecontinue
Augmentaugment
Rooroo
Geminigemini
Copilotcopilot
Factoryfactory
使用 --all-agents（默认）以针对所有检测到的代理，或使用 --agent <key> 针对特定代理。

​
olostep list skills

查看哪些技能已安装以及安装在哪些代理中——无需翻阅文件。 
olostep list skills            # 人类可读的摘要
olostep list skills --json     # 机器可读

​
olostep remove skills

从标准存储和代理技能目录中移除Olostep安装的技能文件夹，并清理锁文件。 
# 从所有代理中移除所有Olostep技能
olostep remove skills

# 移除特定技能
olostep remove skills --skill research

# 仅从特定代理中移除
olostep remove skills --agent cursor

# 机器可读的JSON输出
olostep remove skills --json
选项默认值描述
--agent <name>—仅从指定代理中移除——可重复
--all-agents / --no-all-agents--all-agents针对所有检测到的代理
--canonical-dir <path>~/.agents/skills要移除的标准技能目录
--agent-skills-dir <path>—自定义目标技能目录以进行移除
--skill <name>—仅移除匹配的技能——可重复
--json—机器可读的JSON输出
安全性： 只有带有 olostep- 前缀的文件夹会被触及。代理目录中的非Olostep技能文件夹不会被修改。锁文件清理仅移除带有 olostep- 前缀的键。

​
技能发现和格式

通过扫描子目录中的 SKILL.md 文件来发现技能。文件必须包含一个带有 name 和 description 字段的YAML前置块。重复的已消毒名称将被拒绝。 
---
name: my-skill
description: 该技能的功能及使用时机
---

# 我的技能

...技能说明在这里...

​
命名约定

安装的文件夹总是使用 olostep- 前缀——例如 research 变为 olostep-research。名称被消毒为小写，并用 - 替换无效字符。此前缀使Olostep管理的技能清晰可辨，并防止与其他工具发生冲突。

​
相关内容