Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.olostep.com/llms.txt

Use this file to discover all available pages before exploring further.

Install Olostep skill folders directly into your AI coding agents from the command line.
  • Installs Olostep skills into agents like Cursor, Claude, Codex, Windsurf, and more
  • Skills land in a canonical store (~/.agents/skills) and are symlinked or copied into each agent’s skills directory
  • Tracks all installs in a lockfile at ~/.agents/.skill-lock.json
This feature is available via the Olostep CLI.

​
The skills

olostep add skills installs all of these. Each is a SKILL.md your agent reads to know what Olostep can do and when to use it.
SkillWhat it does
scrapeTurn one URL into clean markdown / HTML / JSON / text
searchLive web search — results, answers, and in-site URL discovery
answersCited, structured answers from live web data
crawlAutonomously crawl a whole site
mapDiscover every URL on a site
batchScrape up to 10,000 URLs in parallel
extract-schemaScrape a page into structured JSON matching a schema
docs-to-codeScrape API docs and write working code from them
integrateAuto-install the Olostep SDK into a project
migrate-codeRead a migration guide and update local code
researchCited, comparative web research for a decision
debug-errorLook up an error message against live GitHub / SO / docs
setupTeaches the agent how to configure the MCP server
Skills pair with the MCP server: the MCP server gives the agent the live tools, the skills give it the know-how for when and how to use them.

​
Categories

Every skill belongs to one of three categories:
  • Usage skills — use Olostep’s features: scrape, search, answers, crawl, map, batch.
  • Build skills — install and integrate Olostep into a codebase: setup (configure the MCP server) and integrate (add the Olostep SDK to a project).
  • Workflow skills — produce a deliverable with Olostep: research, docs-to-code, migrate-code, debug-error, extract-schema.
Install just one category with olostep add skills --category usage (or build, or workflow). Each installed skill also references its hosted copy at https://www.olostep.com/skills/<name>/SKILL.md — an agent with web access can fetch the latest version (which may have capabilities added since install), and falls back to the local copy otherwise. Browse all hosted skills at olostep.com/skills.

​
olostep add skills

Syncs skills from a source directory into the CLI, installs them into the canonical store, then deploys them into each agent’s skills directory.

​
Install the CLI

# Global install
npm install -g olostep-cli

# Or run without installing
npx -y olostep-cli@latest add skills

​
Usage

# Install all skills into all detected agents (default)
olostep add skills

# Authenticate first, then install
olostep add skills --login

# Target specific agents
olostep add skills --agent cursor --agent claude

# Always copy instead of symlinking
olostep add skills --link-mode copy

# Machine-readable JSON output
olostep add skills --json

​
Options

OptionDefaultDescription
--login—Run browser login before installing
--source <path>CLI bundled skills dirSkills source directory
--cli-local-dir <path>CLI/skillsDirectory where source skills are synced for CLI-local use
--agent <name>—Target a specific agent — repeatable
--all-agents / --no-all-agents--all-agentsIf no --agent is set, targets all detected installed agents
--global / --no-global--globalInstall into known agent global skill dirs
--canonical-dir <path>~/.agents/skillsCanonical storage location for Olostep skills
--agent-skills-dir <path>—Custom target skills dir (requires --no-global)
--skill <name>—Include only this skill — repeatable
--exclude <name>—Exclude this skill — repeatable
--overwrite / --no-overwrite--overwriteReplace existing targets
--link-mode <auto|symlink|copy>autoauto tries symlink, falls back to copy
--json—Emit machine-readable JSON output
Validation rules:
  • --link-mode must be auto, symlink, or copy
  • --agent-skills-dir requires --no-global
  • --no-global requires --agent-skills-dir
  • Unknown agent names will error
  • An empty skill selection after --skill / --exclude will error

​
JSON output

{
  "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" }
      ]
    }
  ]
}

​
olostep list skills

See which skills are installed and into which agents — without digging through files. 
olostep list skills            # human-readable summary
olostep list skills --json     # machine-readable

​
Skill discovery and format

Skills are discovered by scanning subdirectories for a SKILL.md file. The file must include a frontmatter block with name and description fields. Duplicate sanitized names are rejected. 
---
name: research-agent
description: Autonomous research agent for deep web investigation
---

# Research Agent

...skill instructions here...

​
Supported agents

AgentKey
Cursorcursor
Claudeclaude
Codexcodex
Windsurfwindsurf
Continuecontinue
Augmentaugment
Rooroo
Geminigemini
Copilotcopilot
Factoryfactory
Each key maps to a known home-directory skills path. Use --all-agents (the default) to target all detected installed agents, or pass --agent <key> to target specific ones.

​
Naming convention

Installed folder names always use the olostep- prefix: e.g., research-agent becomes olostep-research-agent. Names are sanitized to lowercase with invalid characters replaced by -. This prefix keeps Olostep-managed skills clearly identifiable and prevents conflicts with other tools.

​
olostep remove skills

Removes Olostep-installed skill folders from the canonical store and agent skill directories, and cleans up the lockfile.

​
Usage

# Remove all Olostep skills from all agents
olostep remove skills

# Remove a specific skill
olostep remove skills --skill research-agent

# Remove from a specific agent only
olostep remove skills --agent cursor

# Machine-readable JSON output
olostep remove skills --json

​
Options

OptionDefaultDescription
--agent <name>—Remove only from specified agent(s) — repeatable
--all-agents / --no-all-agents--all-agentsIf no --agent or custom dir, uses all detected installed agents
--canonical-dir <path>~/.agents/skillsCanonical skills directory to remove from
--agent-skills-dir <path>—Custom target skills directory for removal
--skill <name>—Remove only matching skill(s) — repeatable
--json—Emit machine-readable JSON output
Safety: Only folders with the olostep- prefix are touched. Non-Olostep agent folders are never modified. Lockfile cleanup only removes olostep--prefixed keys.