mac-debug SKILL.md skillA

mac-debug from calebnewtonusc/chewbacca is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add calebnewtonusc/chewbacca/mac-debug@git:20260904.ee0eb1b

Pins git:20260904.ee0eb1b in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
calebnewtonusc/chewbacca
Path
skills/mac-debug/SKILL.md
Versions recorded
2
Latest version
git:20260904.ee0eb1b, committed Sep 4, 2026
First version recorded
Sep 4, 2026
Size
4,285 bytes
Repository stars
9
License
MIT

Diagnose a Mac automation that is failing, especially one failing silently. Use when a click does nothing, typing does not appear, the accessibility tree is empty, an AppleScript hangs or errors, coordinates land in the wrong place, or something that worked before stopped working.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Debugging Mac automation

Most of these fail with no error, which is what makes them expensive. Diagnose before
you retry, and **never respond to a failure by escalating to a screenshot.** A failing
layer-3 read almost always means one specific fixable thing.

## Triage

```bash
chewie doctor                    # grants, host app, tools
chewie doctor --secure-input     # is the keyboard being blocked
```

## By symptom

### Typing does nothing, no error
**Secure Input.** A password field has focus somewhere, and macOS discards synthetic
keystrokes with no error. It is a process-global reference-counted flag, so one stuck
app starves the whole system.

```bash
ioreg -l -w 0 -d 1 -k IOConsoleUsers | grep -o 'kCGSSessionSecureInputPID"=[0-9]*'
```

Nonzero is the pid holding it. Fix: `open -a Finder`, retry. If an app is stuck, focus
and unfocus it, or quit it.

### Clicks do nothing from inside an app
**App Sandbox** silently blocks `CGEvent.post`. No error. No fix inside the sandbox;
this is why every serious macOS automation tool ships outside the App Store.

### Accessibility tree is empty or all elements unnamed
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add calebnewtonusc/chewbacca/mac-debug@sha256:80132c0091511660

The line at the top of this page pins the label git:20260904.ee0eb1b, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_454d3r6mdsl3ntjj.svg)](https://markdownregistry.com/a/art_454d3r6mdsl3ntjj)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, all committed on Sep 4, 2026.

versioncommittedcommitsizeaudit
git:20260904.ee0eb1b latest2026-09-04 ee0eb1b 4,285 BA view · diff
git:20260904.25a1d942026-09-04 25a1d94 4,266 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4285 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

calebnewtonusc/chewbacca · 9 stars · license MIT · pushed 2026-10-03 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_454d3r6mdsl3ntjj
GET https://markdownregistry.com/api/v1/resolve?ref=calebnewtonusc/chewbacca/mac-debug
GET https://markdownregistry.com/api/v1/blob/80132c009151166074e2dd5868763f99c7b4daf514168e4a89e19ed2e42979c7

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from calebnewtonusc/chewbacca

AGENTS.md AGENTS.md file
calebnewtonusc/chewbacca · AGENTS.md
git:20261001.9741b50 · audit A · 9 stars
CLAUDE.md CLAUDE.md file
calebnewtonusc/chewbacca · CLAUDE.md
git:20261001.9741b50 · audit A · 9 stars
CLAUDE.md@hud CLAUDE.md file
calebnewtonusc/chewbacca · hud/CLAUDE.md
git:20260923.73d65e9 · audit A · 9 stars
agent-setup SKILL.md skill
calebnewtonusc/chewbacca · skills/agent-setup/SKILL.md · Finish the parts of this kit's install that need a browser or a permission dialog: screen and accessibility grants…
git:20260904.ee0eb1b · audit A · 9 stars
asa SKILL.md skill
calebnewtonusc/chewbacca · skills/asa/SKILL.md · Answer from the A2A Spring 2026 course, 108 hours of workshops on building a business out of AI agents. Use when the…
git:20260921.3f3d9a0 · audit A · 9 stars
audio-brief SKILL.md skill
calebnewtonusc/chewbacca · skills/audio-brief/SKILL.md · Turn a piece of work into something the user can listen to instead of read. Use when they say they want to hear it…
git:20260923.c7250b6 · audit A · 9 stars
call-coach SKILL.md skill
calebnewtonusc/chewbacca · skills/call-coach/SKILL.md · Debrief a sales or client call from its transcript or recording. Use when the user shares a call transcript, mentions a…
git:20261003.ae04bdc · audit A · 9 stars
clay-navigation SKILL.md skill
calebnewtonusc/chewbacca · skills/clay-navigation/SKILL.md · Navigate Clay directly with the built-in UX engine, configure native enrichment and dynamic per-row copy, and preserve…
git:20260923.251cbb2 · audit A · 9 stars
clone-site SKILL.md skill
calebnewtonusc/chewbacca · skills/clone-site/SKILL.md · Rebuild an existing website faithfully: a replica, a design study, or a page that has to match a reference. Use when…
git:20260927.8453493 · audit A · 9 stars
coursework SKILL.md skill
calebnewtonusc/chewbacca · skills/coursework/SKILL.md · Run the user's semester from a machine-readable ledger built out of their syllabi. Use when they mention a class, an…
git:20260921.762277d · audit A · 9 stars
creative-video SKILL.md skill
calebnewtonusc/chewbacca · skills/creative-video/SKILL.md · Make a short vertical video for Instagram Reels, YouTube Shorts or TikTok, or a YouTube creative, from a brief written…
git:20260927.eec6d7a · audit A · 9 stars
debugging SKILL.md skill
calebnewtonusc/chewbacca · skills/debugging/SKILL.md · Find the root cause of a bug instead of guessing at it. Use when the user reports something broken, pastes an error or…
git:20260921.84800ca · audit A · 9 stars

Every file in calebnewtonusc/chewbacca

Browse by kind, by grade A, or by owner.