Skip to content

feat(skills): add smart-bash context-compressing bash proxy#14

Open
rrp-bot wants to merge 1 commit into
psav:mainfrom
rrp-bot:feat/smart-bash-skill
Open

feat(skills): add smart-bash context-compressing bash proxy#14
rrp-bot wants to merge 1 commit into
psav:mainfrom
rrp-bot:feat/smart-bash-skill

Conversation

@rrp-bot

@rrp-bot rrp-bot commented Jun 1, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds a new Claude Code skill at .claude/skills/smart-bash.md — a context-compressing bash proxy that runs shell commands and returns a concise 2–5 sentence synthesis rather than raw output.

What the skill does

  • Accepts $ARGUMENTS containing a bash command, with an optional embedded plain-English question or intent
  • Parses the input to extract (a) the command and (b) the intent (inferred from the command if not explicit)
  • Runs the command via the Bash tool
  • Responds in 2–5 sentences, directly answering the question and highlighting only relevant facts — never reproducing raw stdout/stderr

Why context: fork matters

The skill uses context: fork in its frontmatter. This causes Claude to execute the skill in a forked context, meaning the raw command output and intermediate reasoning are discarded after the skill returns. Only the 2–5 sentence synthesis propagates back to the calling context, preventing large terminal outputs from bloating the main conversation thread during long agentic sessions.

Failure handling

When a command exits non-zero or produces error output, the skill explains what failed and provides one specific, actionable fix — rather than quoting the raw error.

Files changed

  • .claude/skills/smart-bash.md (new file) — the skill definition with context: fork frontmatter

Work item

SKILL-SMART-BASH

Generated by spec-to-pr

Introduces .claude/skills/smart-bash.md — a Claude Code skill that runs
bash commands via the Bash tool and returns a concise 2-5 sentence
synthesis rather than raw output. Uses context: fork to avoid polluting
the calling context. Explains failures with a suggested fix.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant