knoopx/bash
agent/skills/tools/bash/SKILL.md
Execute a single shell command in the project working directory. Returns stdout+stderr combined. Stateless — use shell-session for multi-step workflows.
$ install --global
skillsauthnpx skillsauth add knoopx/pi bashInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 18, 2026, 6:42 AM236.2s1 file scanned
SKILL.md
- name:
- bash
- description:
- Execute a single shell command in the project working directory. Returns stdout+stderr combined. Stateless — use shell-session for multi-step workflows.
- token_cost:
- 120
- related:
- [shell-session, nu]
Bash Tool
Execute a single shell command and return stdout+stderr combined.
REQUIRED: command (shell command string) OPTIONAL: timeout (seconds, NO default — always set for installs/builds)
RULES:
- Stateless: each call starts a fresh shell.
cdand env vars do NOT persist. - ALWAYS chain directory changes:
cd /path && command - Set
timeoutfor any command that might take >30s (installs, builds, downloads) - NEVER run interactive commands (
vim,less,top, barepython/nodeREPL) - Prefer dedicated tools (grep, find, ls, read) over bash for file operations
- Output truncated to last 200 lines / 5KB; full output saved to temp file if truncated
EXAMPLE:
{"name": "bash", "input": {"command": "ls -la /home/user/project"}}
EXAMPLE with timeout:
{"name": "bash", "input": {"command": "cd /home/user/project && npm install", "timeout": 120}}
When to use
- Use bash: One-off commands, package installs, builds, quick checks
- Use shell-session: Multi-step workflows, repeated commands, stateful sessions
- Use grep/find/ls: File searching, directory listing, pattern matching (faster, respects .gitignore)
Workflow
- Simple command: Pass the command string directly
- Directory operations: Chain with
&&(e.g.,cd /path && make) - Long-running tasks: ALWAYS set
timeoutto 120-300 for installs, builds, or downloads - Check output: Verify the command succeeded before proceeding
Related Skills
knoopx/notify
tools
VerifiedTrustedCommunity
Inform the user what is happening — skip passive lookups
52SKILL.mdUpdated May 20, 2026
knoopx/markdown-rendering
development
VerifiedTrustedCommunity
Renders markdown to self-contained HTML with a custom dark stylesheet and opens in browser. Use when previewing markdown documents, generating styled HTML from README or report files.
52SKILL.mdUpdated May 20, 2026
knoopx/jj-hunk
testing
VerifiedTrustedCommunity
Programmatic hunk selection for Jujutsu — split, commit, or squash specific hunks without interactive prompts. Use when making partial commits or selective squashes.
52SKILL.mdUpdated May 18, 2026
knoopx/jj-core
content-media
VerifiedTrustedCommunity
Manage version control with Jujutsu (jj) — no staging area, immediate changes, smart rebasing. Use when navigating history, squashing, or pushing to Git remotes.
52SKILL.mdUpdated May 18, 2026