capability-aware-offload-skipping
Skip generic offload wrappers for tools that already bound output locally or would become circular if wrapped again.
What it does
SKILL: Capability-Aware Offload Skipping
Domain: tool-result-storage Trigger: Use when a generic result-offload layer wraps many tools, but some tools already enforce their own output bounds or would recurse if wrapped again. Source Pattern: Distilled from reviewed output-budget enforcement and selective offload-policy implementations.
Core Method
Before applying a generic persistence or preview wrapper, inspect each tool's declared behavior and opt out the tools whose own contract already bounds output or would create a circular readback loop. Treat the skip as a stable policy decision rather than a one-off exception so identical tools keep the same behavior across turns. This preserves the generic offload path where it adds value while avoiding redundant or self-referential wrapping.
Key Rules
- Check declared limits and self-bounded reader behavior before applying a generic offload layer.
- Keep the skip decision stable across turns so identical tool results do not oscillate between wrapped and unwrapped behavior.
- Mark skipped results consistently when broader budgeting logic depends on deterministic treatment across turns.
- Prefer tool-specific contracts over wrapper-level force when the wrapper would just reintroduce the same content through another tool.
Example Application
If a read-style tool already caps output aggressively, exclude it from a generic file-offload wrapper; otherwise the wrapper would persist bounded content and ask the model to read it back through the same tool, adding complexity with no real gain.
Anti-Patterns (What NOT to do)
- Do not wrap every tool uniformly just because a generic offload helper exists; some tools already solve the problem locally.
- Do not let skip decisions fluctuate between turns, or identical tool results will produce inconsistent prompt prefixes and cache behavior.
Capabilities
Install
Quality
deterministic score 0.47 from registry signals: · indexed on github topic:agent-skills · 34 github stars · SKILL.md body (1,881 chars)