CHIS / CHISF

A lightweight skill to standardize how we install/manage OpenClaw skills.

Core idea

• chis \x3Cslug> [workdir] [version] = install a skill from ClawHub.
• chisf \x3Cslug> [workdir] [version] = force-install when the package is flagged/requires overwrite.
• clawhub inspect \x3Cslug> = inspect before install (recommended for validation).
• Always run installs with explicit workdir and skills dir to avoid path confusion.

Default workdir in examples: /Users/zququ/.openclaw/workspace.

Default command mapping

1) Standard install

clawhub install \x3Cslug> --workdir /Users/zququ/.openclaw/workspace --dir skills --version \x3Cversion>

• Omit --version for latest.
• If no version argument, installs latest available.

2) Force install

clawhub install \x3Cslug> --force --workdir /Users/zququ/.openclaw/workspace --dir skills --version \x3Cversion>

Use this when:

• package is flagged as suspicious
• overwrite behavior is required

3) Inspect before install (recommended)

clawhub inspect \x3Cslug>

4) Verify

clawhub list --workdir /Users/zququ/.openclaw/workspace --dir skills

CHIS aliases

Use these shortcuts in practice:

• chis \x3Cslug> → same as standard install in default workspace.
• chisf \x3Cslug> → same as force install in default workspace.
• If needed, set your session path context and explicitly pass an alternate path:
  • chis --workdir /alt/path \x3Cslug>
  • chisf --workdir /alt/path \x3Cslug>

Failure handling

1. If Rate limit exceeded: retry after a few minutes.
2. If command fails due to path mismatch: ensure you are checking with same --workdir and --dir skills used during install.
3. If package not found: confirm correct slug via clawhub search \x3Ckeyword>.

Safe defaults for this environment

• Use:

  • --workdir /Users/zququ/.openclaw/workspace
  • --dir skills

• Already-known working example:

clawhub install proactive-agent --force --workdir /Users/zququ/.openclaw/workspace --dir skills

Notes

• CHISF is a human-facing label I use for force-install style operations.
• Keep all install actions explicit and repeatable; never rely on default working dir.
• Failure handling
  • If install fails, run clawhub inspect \x3Cslug> --workdir /Users/zququ/.openclaw/workspace --dir skills for a quick pre-check.
  • If it still fails due to environment mismatch, re-run with explicit --workdir /Users/zququ/.openclaw/workspace and --dir skills (never rely on implicit defaults).
• For suspected API/service issues (e.g., rate limit exceeded), prefer 10–20 minute pause and retry.
• If rate limit persists, use the local fallback installer: /Users/zququ/.local/bin/clawhub-install-safe --force \x3Cslug> \x3Cworkdir> (or without --force when not needed) before switching to another approach.
• Keep the same --workdir and --dir skills/registry context when re-running.