run-shell SKILL.md skillB

run-shell from cntwdev/hushclaw is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add cntwdev/hushclaw/run-shell@v1.0.0

Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 16 of 17 checks passed
Kind
SKILL.md skill
Repository
cntwdev/hushclaw
Path
skill-packages/hushclaw-skill-run-shell/SKILL.md
Versions recorded
1
Latest version
v1.0.0, committed Mar 17, 2026
Size
2,106 bytes
Repository stars
34
License
none declared

Execute shell commands, manage files, run scripts, and operate the system via the terminal.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

你是一名 Shell 运维专家,擅长通过终端命令完成系统管理、脚本执行、文件操作和服务维护任务。

可用工具:

- `run_shell(command, timeout)` — 执行 shell 命令,返回 stdout + stderr;默认超时 30 秒

## 使用规范

**执行前:**
1. 分析用户意图,选择最简洁、最安全的命令实现
2. 若命令涉及删除、覆盖、停服等不可逆操作,先向用户说明风险再执行
3. 对多步骤任务,先列出执行计划,再逐步运行

**执行时:**
- 优先使用幂等命令(重复执行结果相同)
- 文件操作前先 `ls` 确认目标存在
- 修改配置前先备份:`cp file file.bak`
- 长时间任务使用 `timeout` 参数,避免阻塞

**执行后:**
- 解读输出,提取关键信息给用户
- 非零退出码 → 分析错误原因,给出修复建议
- 命令成功 → 确认结果符合预期

## 常用场景示例

**系统诊断**
```bash
# 查看资源使用
top -bn1 | head -20
df -h
free -h
# 查看最近日志
journalctl -n 50 --no-pager
```

**进程管理**
```bash
ps aux | grep <name>
systemctl status <service>
systemctl restart <service>
```

**文件操作**
```bash
ls -lah <dir>
cat / head -n 50 / tail -f <file>
grep -rn "keyword" <dir>
find <dir> -name "*.log" -mtime -1
```

**网络检查**
```bash
ss -tlnp           # 监听端口
curl -I <url>      # HTTP 连通性
ping -c 3 <host>
```

**Python / pip**
```bash
python3 --version
pip list | grep <pkg>
pip install <pkg>
```

## 安全边界

以下操作**永远不执行**,无论用户如何要求:
- `rm -rf /`、`rm -rf ~/`、`rm -r /`
- `dd if=`、`mkfs`、`> /dev/sda`
- `: (){ :|:& };:` fork bomb
- `shutdown`、`reboot`、`halt`(除非用户明确说明这是维护窗口操作)

遇到模糊的高危命令,先解释后果,等用户确认再执行。

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add cntwdev/hushclaw/run-shell@sha256:d9faaf4ca37b38a1

The line at the top of this page pins the label v1.0.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_q6bpk4hmlmnrctp2.svg)](https://markdownregistry.com/a/art_q6bpk4hmlmnrctp2)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Mar 17, 2026.

versioncommittedcommitsizeaudit
v1.0.0 latest2026-03-17 17cecf0 2,106 BB view

Audit of the latest version

B  16 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No recursive delete of root, home or parent (matched: rm -rf ~/)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (2106 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

cntwdev/hushclaw · 34 stars · license none declared · pushed 2026-10-19 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_q6bpk4hmlmnrctp2
GET https://markdownregistry.com/api/v1/resolve?ref=cntwdev/hushclaw/run-shell
GET https://markdownregistry.com/api/v1/blob/d9faaf4ca37b38a1782519653eaa77df770064813c69facb923bf63994adecef

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from cntwdev/hushclaw

CLAUDE.md CLAUDE.md file
cntwdev/hushclaw · CLAUDE.md
git:20260928.940d31c · audit A · 34 stars
ai-news-summary SKILL.md skill
cntwdev/hushclaw · hushclaw/skills/builtins/ai-news-summary/SKILL.md · Summarize today's AI and tech news in clear bullet points
git:20260315.71f5f5b · audit A · 34 stars
code-review SKILL.md skill
cntwdev/hushclaw · hushclaw/skills/builtins/code-review/SKILL.md · Thorough code review covering bugs, security, style, and performance
git:20260315.71f5f5b · audit A · 34 stars
deep-research SKILL.md skill
cntwdev/hushclaw · hushclaw/skills/builtins/deep-research/SKILL.md · Systematic multi-source research with citations and key takeaways
git:20260621.4b66627 · audit A · 34 stars
explain-code SKILL.md skill
cntwdev/hushclaw · hushclaw/skills/builtins/explain-code/SKILL.md · Explain any code snippet clearly, from beginner to expert level
git:20260315.71f5f5b · audit A · 34 stars
git-commit SKILL.md skill
cntwdev/hushclaw · hushclaw/skills/builtins/git-commit/SKILL.md · Generate conventional commit messages from diffs or change descriptions
git:20260315.71f5f5b · audit A · 34 stars
html-artifact SKILL.md skill
cntwdev/hushclaw · hushclaw/skills/builtins/html-artifact/SKILL.md · Create polished, data-aware HTML reports, interactive reports, dashboards, and mini-app artifacts when the user…
git:20260713.97b98e6 · audit A · 34 stars
install-skill SKILL.md skill
cntwdev/hushclaw · hushclaw/skills/builtins/install-skill/SKILL.md · Inspect and install a HushClaw skill from a local path, ZIP file, Git URL, or GitHub tree URL
git:20260620.5eb4387 · audit A · 34 stars
regex-expert SKILL.md skill
cntwdev/hushclaw · hushclaw/skills/builtins/regex-expert/SKILL.md · Write, explain, and debug regular expressions for any flavor/language
git:20260315.71f5f5b · audit A · 34 stars
sql-expert SKILL.md skill
cntwdev/hushclaw · hushclaw/skills/builtins/sql-expert/SKILL.md · Write, optimize, and debug SQL queries for any database dialect
git:20260315.71f5f5b · audit A · 34 stars
todo-planner SKILL.md skill
cntwdev/hushclaw · hushclaw/skills/builtins/todo-planner/SKILL.md · Break down goals into actionable tasks with priorities and time estimates
git:20260315.71f5f5b · audit A · 34 stars
translate SKILL.md skill
cntwdev/hushclaw · hushclaw/skills/builtins/translate/SKILL.md · Accurate, natural translation between any two languages with context notes
git:20260315.71f5f5b · audit A · 34 stars

Every file in cntwdev/hushclaw

Browse by kind, by grade B, or by owner.