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

​
olostep add skills

从源目录同步技能到CLI，将其安装到标准存储中，然后部署到每个代理的技能目录中。

​
安装CLI

# 全局安装
npm install -g olostep-cli

# 或者无需安装直接运行
npx -y olostep-cli@latest add skills

​
用法

# 将所有技能安装到所有检测到的代理中（默认）
olostep add skills

# 先认证，然后安装
olostep add skills --login

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

# 始终复制而不是符号链接
olostep add skills --link-mode copy

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

​
选项

选项默认描述
--login—安装前运行浏览器登录
--source <path>CLI捆绑的技能目录技能源目录
--cli-local-dir <path>CLI/skills源技能同步到的CLI本地使用目录
--agent <name>—目标特定代理 — 可重复
--all-agents / --no-all-agents--all-agents如果未设置--agent，则目标为所有检测到的已安装代理
--global / --no-global--global安装到已知代理的全局技能目录
--canonical-dir <path>~/.agents/skillsOlostep技能的标准存储位置
--agent-skills-dir <path>—自定义目标技能目录（需要--no-global）
--skill <name>—仅包含此技能 — 可重复
--exclude <name>—排除此技能 — 可重复
--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输出

{
  "sync": {
    "plugin_source_dir": "/path/to/CLI/skills",
    "cli_local_dir": "/path/to/CLI/skills"
  },
  "selected_skills": ["research-agent"],
  "canonical_dir": "~/.agents/skills",
  "lockfile_path": "~/.agents/.skill-lock.json",
  "installed": [
    {
      "skill": "research-agent",
      "canonical_path": "~/.agents/skills/olostep-research-agent",
      "targets": [
        { "agent": "cursor", "mode": "symlink", "path": "~/.cursor/skills/olostep-research-agent" },
        { "agent": "claude", "mode": "symlink", "path": "~/.claude/skills/olostep-research-agent" }
      ]
    }
  ]
}

​
技能发现和格式

通过扫描子目录中的SKILL.md文件来发现技能。文件必须包含一个带有name和description字段的前言块。重复的已消毒名称将被拒绝。 
---
name: research-agent
description: 用于深度网络调查的自主研究代理
---

# 研究代理

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

​
支持的代理

代理键
Cursorcursor
Claudeclaude
Codexcodex
Windsurfwindsurf
Continuecontinue
Augmentaugment
Rooroo
Geminigemini
Copilotcopilot
Factoryfactory
每个键映射到已知的主目录技能路径。使用--all-agents（默认）来目标所有检测到的已安装代理，或者传递--agent <key>来目标特定代理。

​
命名约定

安装的文件夹名称始终使用olostep-前缀：例如，research-agent变为olostep-research-agent。名称被消毒为小写，非法字符被替换为-。此前缀使Olostep管理的技能易于识别，并防止与其他工具冲突。

​
olostep remove skills

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

​
用法

# 从所有代理中移除所有Olostep技能
olostep remove skills

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

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

# 机器可读的JSON输出
olostep remove skills --json

​
选项

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