Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add catcatcatstudio/cat-skills --skill xraygit clone --depth 1 https://github.com/catcatcatstudio/cat-skillsWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/catcatcatstudio/cat-skills/xray)<a href="https://agentmods.dev/skills/catcatcatstudio/cat-skills/xray"><img src="https://agentmods.dev/badge/skills/catcatcatstudio/cat-skills/xray.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00106 | $0.02518 |
| Opus 5 | $0.00053 | $0.01259 |
| Sonnet 5 | $0.00021 | $0.00504 |
| Haiku 4.5 | $0.00011 | $0.00252 |
Grade A, and why
xray scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 240 lines — stays where its author put it; the contents beside it link to each section on GitHub.
xray — X/Twitter Content Intelligence
Graph-based X intelligence. Every command operates on your social graph first, broad search second. Money stays focused on accounts and topics that matter to you.
First Run
If xray isn't configured, run setup:
bun run xray.ts setup
Or in a Claude Code session, say "set up xray for me" — the agent will walk you through it conversationally.
Setup builds your config.json through an interview:
- Your accounts — what you post from (powers
mirror) - Your lanes — topics you care about (powers
pulse) - Engage accounts — bigger accounts you reply to (powers
scout) - Track accounts — accounts you study (powers
track)
Everything saves to config.json. Edit it anytime. Your graph grows as you discover people worth following.
Agent-Driven Setup
When running inside Claude Code and the user asks to set up xray, DON'T just run the CLI interview. Instead, conduct the setup conversationally:
- Ask what their X handle is
- Ask what topics they post about — suggest lane presets that match
- Ask who they engage with regularly (bigger accounts in their space)
- Ask who they study/compete with
- Build config.json from the answers using the Write tool
This feels more natural than a CLI form. Use the lane presets from xray.ts as options — they cover: design, ai, dev, startup, creative, crypto, marketing, studio.
Requirements
- Bun (runtime): https://bun.sh
- X_BEARER_TOKEN (X API): Get at https://developer.x.com (pay-per-use, no subscription)
- Add to your env:
export X_BEARER_TOKEN=your_token - Or add to
~/.env.keys:X_BEARER_TOKEN=your_token
- Add to your env:
Quick Reference
| Command | What it does | Cost | When |
|---|---|---|---|
scout |
Reply opportunities from your graph | ~$0.50-1.50 | Daily, before posting |
pulse <lane> |
What's hot in a topic lane | ~$1.00-2.00 | Daily, content ideas |
track |
Top posts from tracked accounts | ~$1.00-2.50 | Weekly, competitive intel |
mirror |
Your own accounts' performance | ~$1.50 | Weekly review |
prospect |
Founders who just launched | ~$1.00-2.00 | Finding clients |
search <query> |
General search (recent or archive) | ~$0.50/page | Ad-hoc research |
setup |
Build your config interactively | free | First run |
What ships with it
1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 8d ago First seen · 240 lines · 106 tokens per session scan A 6bb2638fc619
xray is a skill published in the GitHub repository catcatcatstudio/cat-skills (3 stars, last pushed 12d ago), licensed MIT. It adds 106 tokens to every session and 2,518 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
watch
Watch live IDX turnover and order books for unusual activity — value surges, auto-reject approach, one-sided depth, walls appearing or withdrawn, quiet stocks waking up, UMA flags — plus delayed print-by-print attribution and end-of-day broker context. Use when the user runs /watch, or asks what is trading right now…
stockbit-status
Check whether the Stockbit session is still valid — main session expiry, whether trading credentials are stored, and the current trading mode. Use when the user asks "am I still logged in to Stockbit", "has my session expired", "is trading on", or when a stockbit MCP tool starts failing with an auth error.
stockbit-auth
Log in to Stockbit and capture the session for this server — opens the browser login flow and verifies the token was stored. Use when the user asks to log in or re-authenticate to Stockbit, or after a status check reports the session expired, HTTP 401, or logged out.
recursive-decomposition
Handle tasks that exceed the context window by decomposing them: size and filter the input, chunk it, run recursive sub-agents on independent parts, verify on small windows, and synthesise programmatically, following the Recursive Language Models (RLM) research by Zhang, Kraska and Khattab (2025). Use when a task…
bandar-check
Answer "who is accumulating this stock?" for an IDX ticker using Stockbit broker-flow data. Use when the user asks about bandar, big money, accumulation, distribution, foreign flow, asing, or who is on the other side of the tape.
trade-with-guardrails
Place an order through the user's own Stockbit account safely — check the mode, size the position from a risk budget, preview, read the summary back to the human, and only then write. Use when the user asks to buy, sell, amend or cancel an order, or to size a trade.