capability-aware-offload-skipping
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.