Grok Bot Local First (v0.1.3)

The problem

LLM tokens are expensive and context windows are fragile. Developer workflows often waste high-reasoning model turns on deterministic tasks like file listing, secret scanning, or log parsing that a local script could handle for free.

What it does

• Standardizes a Python 3.12 CLI worker contract for local task execution.
• Provides a library of policy gates, safety scanners, and meta-triage tools.
• Enforces "judgment-only" routing to ensure the LLM only triggers when local logic signals a failure or a need for human review.
• Implements progressive disclosure to prevent context bloat by returning capped, structured JSON digests.

Frameworks & tools

Python 3.12 (stdlib focused), Grok Bot 0.27.0+, Windows-first file paths (path-agnostic core).

Why this beats prompting it yourself

Writing individual scripts is easy, but managing the orchestration between a local runner and an LLM requires a strict communication contract. This skill provides that pre-defined interface, preventing the model from hallucinating worker capabilities or reimplementing local logic in the chat buffer.

Use cases

• Pre-flight safety checks to scan for secrets before the LLM processes code.
• Managing context budgets by providing summarized MD outlines instead of full file bodies.
• Automated triage of "drop" folders to validate external script contributions against a linting contract.
• Staleness detection to ensure the bot isn't working on outdated artifacts.

Known limitations

Requires a local Python 3.12 runner to be set up on the host machine (this gets setup by Grok Bot if Python is installed). Designed specifically for the Grok Bot harness but adaptable to other CLI-capable agents.