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 antonio-mello-ai/iterm-ai-agents-bundle --skill iterm-diagnosticsgit clone --depth 1 https://github.com/antonio-mello-ai/iterm-ai-agents-bundleWrote 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/antonio-mello-ai/iterm-ai-agents-bundle/iterm-diagnostics)<a href="https://agentmods.dev/skills/antonio-mello-ai/iterm-ai-agents-bundle/iterm-diagnostics"><img src="https://agentmods.dev/badge/skills/antonio-mello-ai/iterm-ai-agents-bundle/iterm-diagnostics/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/antonio-mello-ai/iterm-ai-agents-bundle/iterm-diagnostics"><img src="https://agentmods.dev/badge/skills/antonio-mello-ai/iterm-ai-agents-bundle/iterm-diagnostics.svg" alt="Reviewed on agentmods" width="80" 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.00050 | $0.00464 |
| Opus 5 | $0.00025 | $0.00232 |
| Sonnet 5 | $0.00010 | $0.00093 |
| Haiku 4.5 | $0.00005 | $0.00046 |
Grade A, and why
iterm-diagnostics 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 10d 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.
What it actually says
iTerm Diagnostics
Use this skill to collect a read-only health report for iTerm automation. Do not dump shell history, environment variables, prompts, tokens, or command output from panes.
Quick Report
skills/iterm-diagnostics/scripts/iterm-diagnostics
Use context only when the issue depends on pane identity:
skills/iterm-diagnostics/scripts/iterm-diagnostics --include-context
Run a visible badge test only when the user is ready for a small UI change:
skills/iterm-diagnostics/scripts/iterm-diagnostics --test-badge "diag"
What It Checks
osascriptis available.- iTerm responds as
com.googlecode.iterm2. - The current iTerm session can be read.
- Windows, tabs, sessions, names, and TTYs can be enumerated.
- Caller/current target resolution works.
- Optional badge test can write an OSC 1337 badge to the current session.
Interpretation
iterm_bundlefails: iTerm is missing, renamed, or AppleScript cannot resolve it.current_sessionfails: iTerm is closed, has no windows, or Automation permission is blocked.list_sessionsfails: AppleScript access is blocked or the iTerm scripting dictionary changed.identifyreportscaller-fallback-current: the agent runtime has no TTY, so targeting is based on the current iTerm focus.- Screenshot failures usually point to macOS Screen Recording permission.
Rules
- Stay read-only unless the user asked for a visible test.
- Do not include pane contents in reports.
- Use
--include-contextonly when session names and TTYs are needed. - After changing permissions or fixing a helper script, rerun the diagnostic and report changed checks.
Reference
- references/permissions.md lists the macOS permissions involved.
What ships with it
3 files 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.
- 10d ago First seen · 57 lines · 50 tokens per session scan A 1f19035ff748
iterm-diagnostics is a skill published in the GitHub repository antonio-mello-ai/iterm-ai-agents-bundle (2 stars, last pushed 2mo ago), licensed MIT. It adds 50 tokens to every session and 464 once invoked, about $0.0003 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
performance-optimization
Optimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks.
gke-node-notready
Diagnoses GKE nodes reporting NotReady or Unknown status by inspecting node conditions, events, kubelet/containerd logs, and node metrics, then proposing safe remediations. Use when nodes show NotReady, when the kubelet stops posting node status, or when workloads are evicted or stuck Pending due to node health. Don't…
gke-ai-troubleshooting-jobset-interruption
Diagnoses GKE JobSet interruptions, restarts, and preemptions for AI/ML training workloads autonomously. Use when troubleshooting JobSet restart loops, spot VM preemptions, node readiness failures, host VM issues, or coordinator worker crashes. Don't use for general GKE cluster creation, basic workload deployment, or…
gke-ai-troubleshooting-tpu-vbar-oom
Diagnoses and prevents vbarcontrolagent segfaults, out-of-memory (OOM) errors, and TPU device initialization failures on TPU v6e nodes in GKE caused by race conditions during TPU device resets or high-frequency metrics polling. Use when troubleshooting vbarcontrolagent crashes, memory cgroup OOMs in serial console…
systematic-debugging
A step-by-step method for finding the underlying cause of technical problems before changing code. It covers reading errors, reproducing failures, checking recent changes, and tracing data across system components.
fixing-motion-performance
Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.