subagent-timeout-config SKILL.md skillA

subagent-timeout-config from songhonglei/better-agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add songhonglei/better-agent-skills/subagent-timeout-config@git:20260620.275cc89

Pins git:20260620.275cc89 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
songhonglei/better-agent-skills
Path
skills/subagent-timeout-config/SKILL.md
Versions recorded
1
Latest version
git:20260620.275cc89, committed Jun 20, 2026
Size
6,092 bytes
Repository stars
3
License
MIT

One-click subagent timeout configurator for OpenClaw. Configures the three related fields (agents.defaults.timeoutSeconds + subagents.runTimeoutSeconds + acp.runtime.ttlMinutes) atomically with built-in TTL constraint validation (ttlMinutes * 60 ≥ runTimeoutSeconds). Three preset profiles — quick (60s/1h/1h, fast feedback), normal (3min/2h/2h, everyday dev), patient (5min/3h/3h, long-running tasks) — plus --custom for arbitrary values. Auto-backup before write, optional gateway auto-restart…

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

# subagent-timeout-config

- **Author**: Evan Song · [github.com/Songhonglei](https://github.com/Songhonglei)
- **Repository**: https://github.com/Songhonglei/better-agent-skills
- **License**: MIT

One-click timeout configurator for [OpenClaw](https://docs.openclaw.ai)
subagents. Set the three related timeout fields atomically with built-in
constraint validation, automatic backup, and optional gateway restart.

> ⚠️ **OpenClaw-only by default** — reads/writes `~/.openclaw/openclaw.json`.
> Use `--config <path>` to target a different runtime's JSON config file.

---

## Why this skill exists

OpenClaw timeouts are split across **three nested fields** that must be tuned
together:

| Field | Path | What it controls |
|---|---|---|
| `timeoutSeconds` | `agents.defaults.timeoutSeconds` | Per-tool-call wait |
| `runTimeoutSeconds` | `agents.defaults.subagents.runTimeoutSeconds` | Per-subagent task budget |
| `ttlMinutes` | `acp.runtime.ttlMinutes` | ACP session lifetime |

**Hidden trap**: `ttlMinutes * 60` must be `≥ runTimeoutSeconds`, otherwise
sessions die before subagents finish. Default OpenClaw values (30s / 30min /
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add songhonglei/better-agent-skills/subagent-timeout-config@sha256:a3485ef000ad36f6

The line at the top of this page pins the label git:20260620.275cc89, 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_cs3shxeul5juug7l.svg)](https://markdownregistry.com/a/art_cs3shxeul5juug7l)

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

Versions

The registry has recorded 1 version of this file, committed on Jun 20, 2026.

versioncommittedcommitsizeaudit
git:20260620.275cc89 latest2026-06-20 275cc89 6,092 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6092 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 recursive delete of root, home or parent
  • 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

Source

GitHub

songhonglei/better-agent-skills · 3 stars · license MIT · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_cs3shxeul5juug7l
GET https://markdownregistry.com/api/v1/resolve?ref=songhonglei/better-agent-skills/subagent-timeout-config
GET https://markdownregistry.com/api/v1/blob/a3485ef000ad36f6a1b6d8837ec0a4c3d271f9b4e10a02b9f2b2d7b6ecf625e6

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 songhonglei/better-agent-skills

agent-avatar-manager SKILL.md skill
songhonglei/better-agent-skills · skills/agent-avatar-manager/SKILL.md · Manage your OpenClaw Agent's avatar. Send an image/URL directly, or describe a style and let Freepik vector search pick…
git:20260620.089a390 · audit A · 3 stars
agent-team-mesh SKILL.md skill
songhonglei/better-agent-skills · skills/agent-team-mesh/SKILL.md · Team-wide P2P mesh for OpenClaw agents running on different containers/pods. Each agent's gateway listens on its own…
git:20260620.8ade89c · audit A · 3 stars
claw-memory-manager SKILL.md skill
songhonglei/better-agent-skills · skills/claw-memory-manager/SKILL.md · Manage OpenClaw Agent's built-in memory features — enable/disable/configure Dreaming (Light→REM→Deep auto memory…
git:20260717.e9363e3 · audit A · 3 stars
codex-thread-repair SKILL.md skill
songhonglei/better-agent-skills · skills/codex-thread-repair/SKILL.md · Diagnose and safely repair one local Codex Desktop task selected by its UI title or thread ID when recent turns are…
git:20260907.152df01 · audit A · 3 stars
collective-memory SKILL.md skill
songhonglei/better-agent-skills · skills/collective-memory/SKILL.md · Broadcast a single memory note to multiple AI-agent workspaces in one shot, upserting into MEMORY.md / AGENTS.md /…
git:20260620.15b2a30 · audit A · 3 stars
copy-my-profile SKILL.md skill
songhonglei/better-agent-skills · skills/copy-my-profile/SKILL.md · Extract a standardized cross-tool user profile from any AI agent's long-term memory (USER.md, MEMORY.md, AGENTS.md…
git:20260620.dd6cf2d · audit A · 3 stars
hello-env SKILL.md skill
songhonglei/better-agent-skills · skills/hello-env/SKILL.md · Zero-dependency Bash environment health check for Linux, macOS, containers, and K8s pods. Reports OS, current user…
git:20261017.7e50876 · audit A · 3 stars
init-hooks SKILL.md skill
songhonglei/better-agent-skills · skills/init-hooks/SKILL.md · 管理 OpenClaw 容器启动时自动执行的脚本钩子。gateway 重启、pod 重启、pod 重建均不丢失(数据持久化在 workspace/.init-hooks/)。 支持 inline…
git:20261017.7e50876 · audit A · 3 stars
multica-squad-load-balancer SKILL.md skill
songhonglei/better-agent-skills · skills/multica-squad-load-balancer/SKILL.md · Multica 小队公共负载均衡。小队 Issue 由队长按实时活跃任务数、运行环境、并发容量和所需技能委派一名成员;成员校验委派链后执行原业务。用于小队派单、成员接单、重复唤醒对账和负载预览,适用于任意项目。
git:20261019.750dc9a · audit A · 3 stars
multica-squad-onboard SKILL.md skill
songhonglei/better-agent-skills · skills/multica-squad-onboard/SKILL.md · 根据 Multica 项目 ID 或 URL 检查现有小队前提,安装公共负载均衡 Skill,配置项目、小队及不同角色的项目作用域 Instruction,并只读验收。当用户要求小队首次接入、配置复查或补装时使用;实际业务派单使用…
git:20261019.750dc9a · audit A · 3 stars
openviking-projects SKILL.md skill
songhonglei/better-agent-skills · skills/openviking-projects/SKILL.md · 在新电脑安装或接入 OpenViking,用白名单管理本地项目知识;支持 GitHub 不通时的镜像安装、模型权限检查、只读 MCP、多项目路由与增量同步。用于 OpenViking 项目知识接入和运维;聊天记忆插件另行选择。
git:20261107.e9b5934 · audit A · 3 stars
recover-codex-project-chats SKILL.md skill
songhonglei/better-agent-skills · skills/recover-codex-project-chats/SKILL.md · Diagnose and safely repair Codex Desktop projects that exist but show “No chats/没有聊天”, while conversations may still…
git:20260806.6eddb52 · audit A · 3 stars

Every file in songhonglei/better-agent-skills

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