skill-add

Other Community

Repo stars 707
Author repo openclacky

Interpretation is structured for decision-making; original keeps the upstream SKILL.md unchanged.

Decide Fit First

Core job: Installs a skill from a zip URL or a local zip file path using the bundled installfromzip.rb script. The script path is listed i…
Best fit: Use it when the task has reusable inputs, steps, and validation criteria rather than a one-off answer.
Avoid forcing it: If the source lacks commands, platform support, or external-service evidence, keep those fields unknown instead of guessing.

Design Intent

Structure: The skill is organized around “How to Install”, “Examples”, “Notes”, showing how the author expects the agent to judge fit, collect context, and produce verifiable output.
Trigger evidence: Prioritize the author’s wording around when to use it, what context to collect, and what output shape to produce.
Evidence boundary: Author text states facts, repository files prove commands and paths, and Fluxly only adds fit, limits, and usage judgment.

How To Use It

Inputs: Provide target material, scope, expected result, forbidden changes, and validation method.
Invocation: Name skill-add directly; if the source includes slash commands, start with the command and then add task context.
Validation: Start small and check whether the result follows “How to Install / Examples / Notes” before expanding.

Boundaries And Review

Dependencies: It usually needs no extra API key, so start with a small validation task.
Permissions: Declared permissions include read; ask the agent to state file, command, and rollback boundaries before acting.
Quality bar: A useful result names the deliverable, evidence, and next action. Generic prose means the task needs tighter context.

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:

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

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

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

Fluxly profile Author and license come from source; runtime, permissions, and network are Fluxly detections or estimates

Fluxly category: 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
Author / version / license: @clacky-ai · no license declared
Fluxly token estimate: Lean
Fluxly setup estimate: Plug-and-play
External API key: No requirement detected
Detected OS requirements: Unspecified
Runtime requirements: Unspecified
Detected file/system behavior: Read-only
Detected network behavior: Local-only
Install commands: None (reference only)

Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.

Heads up: 未限定 allowed-tools，默认拥有全部工具权限。

Output preview skill-add.preview

The current SKILL.md does not define a fixed output example.

SKILL.md SKILL.md

# 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

Evidence boundary and execution chain

Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.

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 -> installfromzip.rb · scripts/installfromzip.rb · find · <zipurlorpath> · https:// · .zip · [slug] · canvas-design-1.2.0.zip
body sha256 -> c69dc8d09923