skill add
- Repo stars 707
- Author repo openclacky
- Domain
- Other
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @clacky-ai · no license declared
- Token usage
- Lean
- Setup complexity
- Plug-and-play
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# Skill Add — Zip Installer
Installs a skill from a zip URL **or a local zip file path** using the bundled `install_from_zip.rb` script.
## How to Install
The script path is listed in the Supporting Files above (`scripts/install_from_zip.rb`) — use the full path directly, no `find` needed.
The script accepts **either a remote URL or a local file path**:
```bash
ruby "SKILL_DIR/scripts/install_from_zip.rb" <zip_url_or_path> [slug]
```
- `<zip_url_or_path>` — a remote `https://` URL **or** an absolute/relative local path to a `.zip` file
- `[slug]` — optional; the skill's directory name. If omitted, inferred from the filename (e.g. `canvas-design-1.2.0.zip` → `canvas-design`)
The script handles everything automatically:
- For URLs: downloads the zip (follows HTTP redirects)
- For local paths: reads the file directly (no download needed)
- Extracts and locates all `SKILL.md` files inside
- Copies skill directories to `~/.clacky/skills/`
- Reports installed skills with their descriptions
**Do NOT manually download or unzip — the script handles everything.**
## Examples
**From a remote URL:**
```
/skill-add https://store.clacky.ai/skills/canvas-design-1.2.0.zip
```
```bash
ruby "SKILL_DIR/scripts/install_from_zip.rb" \
"https://store.clacky.ai/skills/canvas-design-1.2.0.zip" \
"canvas-design"
```
**From a local file:**
```
/skill-add /Users/alice/Downloads/my-skill-1.0.0.zip
```
```bash
ruby "SKILL_DIR/scripts/install_from_zip.rb" \
"/Users/alice/Downloads/my-skill-1.0.0.zip"
```
## Notes
- Skills install to `~/.clacky/skills/` by default
- Local paths may be absolute (`/path/to/skill.zip`) or use `~` (`~/Downloads/skill.zip`)
- If the user doesn't provide a URL or path, ask them for the zip source
Sections and files
Listed in source order.
sections -> How to Install → Examples → Notes
terms -> or a local zip file path · either a remote URL or a local file path · or · Do NOT manually download or unzip — the script handles everything. · From a remote URL · From a local file
files/cmd -> install_from_zip.rb · scripts/install_from_zip.rb · find · <zip_url_or_path> · https:// · .zip · [slug] · canvas-design-1.2.0.zip
body sha256 -> c69dc8d09923
How to Install
The script path is listed in the Supporting Files above (
scripts/install_from_zip.rb) — use the full path directly, nofindneeded. The script accepts either a remote URL or a local file path:<zip_url_or_path>— a remotehttps://URL or an absolute/relative local path to a.zipfile[slug]— optional; the skill's directory name. If omitted, inferred from the filename (e.g.canvas-design-1.2.0.zip→canvas-design)Examples
From a remote URL: From a local file:
Notes
Skills install to
~/.clacky/skills/by default Local paths may be absolute (/path/to/skill.zip) or use~(~/Downloads/skill.zip) If the user doesn't provide a URL or path, ask them for the zip source