# Send Agi Terminal Helper to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "agi-terminal-helper",
    "name": "Agi Terminal Helper",
    "source": "tencent",
    "type": "skill",
    "category": "安全合规",
    "sourceUrl": "https://clawhub.ai/liuwujijay/agi-terminal-helper",
    "canonicalUrl": "https://clawhub.ai/liuwujijay/agi-terminal-helper",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/agi-terminal-helper",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agi-terminal-helper",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "_meta.json"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "agi-terminal-helper",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-24T01:26:40.331Z",
      "expiresAt": "2026-05-01T01:26:40.331Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agi-terminal-helper",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agi-terminal-helper",
        "contentDisposition": "attachment; filename=\"agi-terminal-helper-1.0.2.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "agi-terminal-helper"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/agi-terminal-helper"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/agi-terminal-helper",
    "downloadUrl": "https://openagent3.xyz/downloads/agi-terminal-helper",
    "agentUrl": "https://openagent3.xyz/skills/agi-terminal-helper/agent",
    "manifestUrl": "https://openagent3.xyz/skills/agi-terminal-helper/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/agi-terminal-helper/agent.md"
  }
}
```
## Documentation

### Terminal Helper — a runbook for OpenClaw exec

This skill is not a “generic terminal tips” template.
It’s a concrete runbook for how to use OpenClaw’s exec tool effectively in a real workspace (like your /Users/.../clawd workspace), with attention to:

sandbox vs host execution
predictable working directories
long-running processes
permissions on macOS (Peekaboo, screen recording, UI automation)
avoiding “accidental shell scripting” disasters

OpenClaw skills are loaded from bundled skills, ~/.openclaw/skills, and <workspace>/skills with workspace taking precedence. :contentReference[oaicite:12]{index=12}

### 1) State the intent + the exact command before running it

Before calling exec, I will say:

what the command is intended to do
what directory it will run in
what files it might read/write
what output I expect (so we can spot anomalies)

### 2) Default to read-only exploration

When debugging or orienting:

pwd, ls -la, git status, rg, cat, head, tail
only escalate to writes/installs after we know what’s going on

### 3) Prefer sandboxed execution for untrusted or high-churn work

Use the sandbox for:

tests, builds, dependency installs
exploring unknown repos
running scripts from third-party sources

Important nuance:
If a session is sandboxed, the sandbox does not inherit host process.env.
Global env and skills.entries.<skill>.env/apiKey apply to host runs only; sandbox env must be set separately. :contentReference[oaicite:13]{index=13}

### 4) Explicit confirmation for anything risky

I will require the user to confirm before:

deleting or overwriting files
installing system-level packages
touching ~/.ssh, keychains, browser profiles
changing network/system settings
running privileged commands (sudo, launchctl changes)

### A) Choose a working directory deliberately

When diagnosing OpenClaw itself, I’ll work inside your workspace (example: /Users/proman/clawd) and be explicit about it.

Typical commands:

check skills:

ls -la ./skills
find ./skills -maxdepth 2 -name SKILL.md -print


check git state:

git status (if the workspace is a git repo)


verify binaries:

which peekaboo || echo "peekaboo not on PATH"

### B) Keep commands single-purpose

Prefer multiple small commands over one “do everything” pipeline. This makes it easier to review and safer to approve.

### C) Long-running commands: background + poll

When supported, run with a short yield and then poll a process session.

Examples you can adapt:

start a long build:

exec: make test (with a short yield)


poll until completion:

process: poll (using the returned session id)

(Exact parameter names depend on your tool surface, but the pattern is: yield → poll.)

### Playbook 1: “My skill isn’t loading”

Confirm skill location/precedence:

OpenClaw loads <workspace>/skills and that wins precedence. :contentReference[oaicite:14]{index=14}


Verify the skill folder has SKILL.md and valid frontmatter.
If you changed files, ensure watcher is enabled:

skills.load.watch: true is the default pattern. :contentReference[oaicite:15]{index=15}

### Playbook 2: “Peekaboo works in Terminal but fails in OpenClaw”

This is usually macOS TCC context + daemon behavior. A common fix is enabling PeekabooBridge in OpenClaw.app:

Settings → Enable Peekaboo Bridge :contentReference[oaicite:16]{index=16}

Then validate:

peekaboo bridge status --verbose should select a host (OpenClaw.app) rather than local (in-process). :contentReference[oaicite:17]{index=17}

### Playbook 3: “ClawHub sync rejects my skill docs”

ClawHub has a quality gate (language-aware word counting and heuristics) that rejects docs that are too thin/templated. :contentReference[oaicite:18]{index=18}
Fix by adding:

concrete examples
troubleshooting
environment notes (sandbox, PATH, permissions)
“what/why/when/how” that is clearly specific to the skill

### What I will NOT do

I will not run remote “install scripts” (e.g., curl | sh) without explicit user request and review.
I will not paste or echo secrets into commands.
I will not make destructive changes without confirming the exact file paths.

### Quick commands I often start with

pwd
ls -la
git status
rg -n "error|warn|TODO" .
uname -a
node -v && python -V

If you want raw, direct execution (no model involvement), use /term.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: liuwujijay
- Version: 1.0.2
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-24T01:26:40.331Z
- Expires at: 2026-05-01T01:26:40.331Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/agi-terminal-helper)
- [Send to Agent page](https://openagent3.xyz/skills/agi-terminal-helper/agent)
- [JSON manifest](https://openagent3.xyz/skills/agi-terminal-helper/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/agi-terminal-helper/agent.md)
- [Download page](https://openagent3.xyz/downloads/agi-terminal-helper)