claw-shell
Use this skill whenever any NeuroClaw skill, sub-agent, or model needs to execute shell commands safely (e.g. source environment scripts, run recon-all, git operations, conda commands, ls, cat logs, etc.). Triggers include: 'run shell', 'execute command', 'shell command', 'tmux claw', 'run in claw session', 'safe shell execution', or any request that requires running terminal commands. This skill is the mandatory gatekeeper for all shell execution in NeuroClaw: it ALWAYS routes commands through the dedicated tmux session `claw`, never touches other sessions, and returns captured output to the
npx skills add BioTender-max/awesome-bio-agent-skills --skill claw-shell --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Claw Shell ## Overview `claw-shell` is the central, safe shell execution layer for the entire NeuroClaw system. All long-running or system-level commands (FreeSurfer recon-all, dependency installation steps, git operations, conda commands, file operations, etc.) are routed through this skill. **Core principles:** - **Always** uses the dedicated tmux session named `claw` (creates it automatically if missing). - **Never** touches any other tmux session or runs commands directly in the main shell. - Captures the latest pane output and returns it to the calling skill/agent. - Enforces strict safety rules: dangerous commands (sudo, rm, reboot, etc.) trigger an explicit user confirmation step before execution. This design solves the problems of the main agent not proactively installing dependencies and handling long-running commands, as identified in the MedicalClaw evaluation, by providing centralized logging, detachment support, and safe execution. ## Quick Reference | Type | Example Commands | Behavior | |-----------------------------------|-------------------------------------------------------|----------| | Safe (direct run) | `ls -la`, `cat log.txt`, `git status` | Executes immed
- Overview
- Quick Reference
- Installation
- Usage Examples
- Example 1: Simple command
- Example 2: FreeSurfer environment + recon-all (delegated from freesurfer-tool)
- Example 3: Dangerous command (safety trigger)
- NeuroClaw recommended wrapper script
- Important Notes & Limitations
- When to Call This Skill
- Complementary / Related Skills
- Reference
Ensure tmux session exists tmux new -s claw -d || true Place files in: skills/claw-shell/ Update SOUL.md and/or USER.md to register as the default shell executor
What does the claw-shell skill do?
Use this skill whenever any NeuroClaw skill, sub-agent, or model needs to execute shell commands safely (e.g. source environment scripts, run recon-all, git operations, conda commands, ls, cat logs, etc.). Triggers include: 'run shell', 'execute command', 'shell command', 'tmux claw', 'run in claw session', 'safe shell execution', or any request that requires running terminal commands. This skill is the mandatory gatekeeper for all shell execution in NeuroClaw: it ALWAYS routes commands through the dedicated tmux session `claw`, never touches other sessions, and returns captured output to the
How do I install it?
Run `npx skills add BioTender-max/awesome-bio-agent-skills --skill claw-shell --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From BioTender-max/awesome-bio-agent-skills, a repository with 135 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.