Skilo
Use Skilo as the sharing layer for agent skills.
When to use this skill
Use this skill when the user wants to:
- share a local skill or all skills from a supported tool
- install a skill from a Skilo link, registry ref, GitHub source,
.skl bundle, or local path
- publish or claim a skill in the Skilo registry
- inspect or verify a skill before installation
- understand which native skill directories a tool uses
- troubleshoot Skilo CLI, API, share-link, or install-target behavior
Core workflow
- Identify the source.
Local path,
SKILL.md, Skilo share link, namespace/name, GitHub source, direct URL, or .skl bundle.
- Choose the operation.
share, add, import, inspect, publish, or claim.
- Choose explicit install targets when installing.
Prefer tool flags over assumptions when the user names a target environment.
- Verify before risky installation.
Use
skilo inspect when the source is untrusted or the user asks to review first.
Commands
Share
npx skilo-cli share ./my-skill
npx skilo-cli share claude
npx skilo-cli share codex -y
Useful options:
--one-time--expires 1h--uses 5--password
Install
npx skilo-cli add https://skilo.xyz/s/abc123 --cc
npx skilo-cli add namespace/skill-name --codex
npx skilo-cli import github:user/repo#skills/my-skill --oc
npx skilo-cli import ./skill.skl --openclaw
add and install are interchangeable.
Native target flags
--cc / --claude-code -> Claude Code--codex -> Codex--cursor -> Cursor--amp -> Amp--windsurf -> Windsurf--oc / --opencode -> OpenCode--cline -> Cline--roo -> Roo--openclaw -> OpenClaw
If no explicit target flag is given, default to Claude Code.
Native install directories
- Claude Code:
~/.claude/skills/
- Codex:
~/.agents/skills/, ~/.codex/skills/
- Cursor:
~/.cursor/skills/
- Amp:
~/.config/agents/skills/
- Windsurf:
~/.codeium/windsurf/skills/
- OpenCode:
~/.config/opencode/skills/
- Cline:
~/.cline/skills/
- Roo:
~/.roo/skills/
- OpenClaw:
~/.openclaw/skills/
Publishing and trust
npx skilo-cli publish
npx skilo-cli claim namespace/skill-name --token <claim-token>
npx skilo-cli inspect https://skilo.xyz/s/abc123
Key trust rules:
- share links can be anonymous and claimed later
- inspect untrusted skills before installation
- checksums and publisher metadata should be surfaced when available
Troubleshooting
- If a share link resolves in the API but not on the site, check the site bundle and API base URL.
- If
npx behaves strangely, verify the installed package version and clear stale _npx cache.
- If installs land in the wrong place, confirm the target flag and the tool’s native skill directory.
- If a custom domain is flaky, test the worker host directly to separate DNS from application failures.
1---2name: skilo3description: Use this skill when the user wants to share, install, inspect, publish, claim, or troubleshoot agent skills with Skilo links, refs, bundles, or tool-native skill directories.4---56# Skilo78Use Skilo as the sharing layer for agent skills.910## When to use this skill1112Use this skill when the user wants to:1314- share a local skill or all skills from a supported tool15- install a skill from a Skilo link, registry ref, GitHub source, `.skl` bundle, or local path16- publish or claim a skill in the Skilo registry17- inspect or verify a skill before installation18- understand which native skill directories a tool uses19- troubleshoot Skilo CLI, API, share-link, or install-target behavior2021## Core workflow22231. Identify the source.24 Local path, `SKILL.md`, Skilo share link, `namespace/name`, GitHub source, direct URL, or `.skl` bundle.252. Choose the operation.26 `share`, `add`, `import`, `inspect`, `publish`, or `claim`.273. Choose explicit install targets when installing.28 Prefer tool flags over assumptions when the user names a target environment.294. Verify before risky installation.30 Use `skilo inspect` when the source is untrusted or the user asks to review first.3132## Commands3334### Share3536```bash37npx skilo-cli share ./my-skill38npx skilo-cli share claude39npx skilo-cli share codex -y40```4142Useful options:4344- `--one-time`45- `--expires 1h`46- `--uses 5`47- `--password`4849### Install5051```bash52npx skilo-cli add https://skilo.xyz/s/abc123 --cc53npx skilo-cli add namespace/skill-name --codex54npx skilo-cli import github:user/repo#skills/my-skill --oc55npx skilo-cli import ./skill.skl --openclaw56```5758`add` and `install` are interchangeable.5960## Native target flags6162- `--cc` / `--claude-code` -> Claude Code63- `--codex` -> Codex64- `--cursor` -> Cursor65- `--amp` -> Amp66- `--windsurf` -> Windsurf67- `--oc` / `--opencode` -> OpenCode68- `--cline` -> Cline69- `--roo` -> Roo70- `--openclaw` -> OpenClaw7172If no explicit target flag is given, default to Claude Code.7374## Native install directories7576- Claude Code: `~/.claude/skills/`77- Codex: `~/.agents/skills/`, `~/.codex/skills/`78- Cursor: `~/.cursor/skills/`79- Amp: `~/.config/agents/skills/`80- Windsurf: `~/.codeium/windsurf/skills/`81- OpenCode: `~/.config/opencode/skills/`82- Cline: `~/.cline/skills/`83- Roo: `~/.roo/skills/`84- OpenClaw: `~/.openclaw/skills/`8586## Publishing and trust8788```bash89npx skilo-cli publish90npx skilo-cli claim namespace/skill-name --token <claim-token>91npx skilo-cli inspect https://skilo.xyz/s/abc12392```9394Key trust rules:9596- share links can be anonymous and claimed later97- inspect untrusted skills before installation98- checksums and publisher metadata should be surfaced when available99100## Troubleshooting101102- If a share link resolves in the API but not on the site, check the site bundle and API base URL.103- If `npx` behaves strangely, verify the installed package version and clear stale `_npx` cache.104- If installs land in the wrong place, confirm the target flag and the tool’s native skill directory.105- If a custom domain is flaky, test the worker host directly to separate DNS from application failures.
yazcaleb