Skills

Context Xray

Inspect and manage the live agent context window with Context X-Ray.

Install

npx skills add BuilderIO/agent-native --skill context-xray -g -a claude-code -y
Category
AI and agents
Updated
3d ago
License
MIT
Context cost
Lightabout 921 tokens
Runs scripts
No, instructions only

What it does

Inspect and manage the live agent context window with Context X-Ray. Use when context is getting large, the user asks what is in context, or stale tool results/files should be pinned, evicted, restored, or reported by an external host.

Context X-Ray

Context X-Ray is the framework's context garbage-collection surface. It shows the current thread's model-bound context as content-derived segments with token counts, then lets the user or agent pin, evict, or restore individual segments.

Actions

ActionWhen to use
context-manifest-getRead the current manifest for a thread. Returns token totals, segment status, source, and whether changes are enforceable.
context-preview-getCompose the would-be system context for the current user/org/app without a live thread. Returns labeled system sections with provenance, governance tier, token counts, and bounded previews. Backs the Agent page Context tab.
context-pinPreserve a segment across future compaction/model calls. Use for task specs, acceptance criteria, user constraints, and other durable context.
context-evictExclude a stale or irrelevant segment from future model calls. Eviction is reversible and never deletes chat history.
context-restoreUndo a pin, evict, or summarize directive for a segment.
context-reportExternal hosts can report their visible context inventory. These manifests are advisory unless Agent-Native owns the emitted content.
context-compactCompact the thread now: fold every not-yet-compacted message into observational memory instead of waiting for the post-turn threshold. Takes effect on the next model call; the transcript is unchanged.

System Sections

Manifests now cover the system-prompt half of context, not just conversation segments. Each system section carries a provenance label (framework-core, actions-prompt, template, enterprise-workspace-core, sql-workspace, legacy-app-default, organization, personal, memory, db-schema, tools, model-overlay, runtime-context) and a governance tier:

Read the whole SKILL.md on GitHub

More in AI and agents