toastty-debug SKILL.md skillA

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

Install it, pinned
mdr add figelwump/toastty/toastty-debug@git:20260605.48a3b8d

Pins git:20260605.48a3b8d in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
figelwump/toastty
Path
.agents/skills/toastty-debug/SKILL.md
Versions recorded
1
Latest version
git:20260605.48a3b8d, committed Jun 5, 2026
Size
5,119 bytes
Repository stars
14
License
MIT

Use this skill when debugging Toastty bugs, crashes, regressions, logs, runtime state, ambiguous running instances, production-vs-worktree target selection, or focused repro plans. It guides log discovery, instance.json targeting, hypothesis-driven debugging, instrumentation, remote/local GUI repro routing, and cleanup.

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

# Toastty Debug

## Overview

Use this workflow to identify the exact Toastty target, gather the right logs/runtime state, and choose a focused repro path before changing code. Keep deterministic validation in `.agents/skills/toastty-verify/SKILL.md`; use this skill for investigation and diagnosis.

## Core Workflow

1. Answer the user's diagnostic question first when they ask what happened or report expected behavior. Do not change code until they ask you to proceed.
2. Identify the target being debugged: production/installed app, current worktree run, named worktree run, Xcode run, smoke/dev run, or an unknown running instance.
3. Resolve the target's log path and runtime state before reading broad process lists.
4. Form 2-3 plausible hypotheses for non-obvious bugs and collect discriminating evidence before choosing a fix direction.
5. Prefer scoped instrumentation when logs are insufficient; remove or downgrade noisy diagnostics after they serve their purpose.
6. After a fix, use `.agents/skills/toastty-verify/SKILL.md` to choose validation, then explain root cause and resolution.

## Target And Log Decision Tree

### Production Or Installed Toastty
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add figelwump/toastty/toastty-debug@sha256:8c7c3bd65877e45e

The line at the top of this page pins the label git:20260605.48a3b8d, 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_dmqkyg67s6lua2zj.svg)](https://markdownregistry.com/a/art_dmqkyg67s6lua2zj)

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

Versions

The registry has recorded 1 version of this file, committed on Jun 5, 2026.

versioncommittedcommitsizeaudit
git:20260605.48a3b8d latest2026-06-05 48a3b8d 5,119 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 (5119 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

figelwump/toastty · 14 stars · license MIT · pushed 2026-10-22 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_dmqkyg67s6lua2zj
GET https://markdownregistry.com/api/v1/resolve?ref=figelwump/toastty/toastty-debug
GET https://markdownregistry.com/api/v1/blob/8c7c3bd65877e45e64043c05ba04b52e003086181e2a8ed047a2317e435e5846

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 figelwump/toastty

toastty-computer-use SKILL.md skill
figelwump/toastty · .agents/skills/toastty-computer-use/SKILL.md · Use this skill when a Toastty GUI bug, fix, or uncertainty needs human-like remote Computer Use interaction beyond the…
git:20260504.5e543a4 · audit A · 14 stars
toastty-dev-run SKILL.md skill
figelwump/toastty · .agents/skills/toastty-dev-run/SKILL.md · Use this skill when building, launching, or validating a live Toastty dev/debug/test app instance with runtime…
git:20260906.d5f2578 · audit A · 14 stars
toastty-diagnostics SKILL.md skill
figelwump/toastty · .agents/skills/toastty-diagnostics/SKILL.md · Use this skill when listing recent Toastty diagnostics submissions, fetching, saving, or analyzing a submitted Toastty…
git:20260821.466cb0c · audit A · 14 stars
toastty-publish SKILL.md skill
figelwump/toastty · .agents/skills/toastty-publish/SKILL.md · Use this skill when publishing an existing Toastty release artifact to GitHub Releases, using already-authored release…
git:20260713.8e1e71a · audit A · 14 stars
toastty-release SKILL.md skill
figelwump/toastty · .agents/skills/toastty-release/SKILL.md · Use this skill when preparing a Toastty app release build, including Ghostty artifact installation, signed DMG…
git:20260713.8e1e71a · audit A · 14 stars
toastty-verify SKILL.md skill
figelwump/toastty · .agents/skills/toastty-verify/SKILL.md · Use this skill when selecting, running, or reporting Toastty verification after code, project, dependency, build, test…
git:20261010.7a86468 · audit A · 14 stars
AGENTS.md AGENTS.md file
figelwump/toastty · AGENTS.md
git:20261017.48aae0e · audit A · 14 stars
worktree-cleanup SKILL.md skill
figelwump/toastty · examples/skills/worktree-cleanup/SKILL.md · Use when the user asks which pull requests or task worktrees are ready to merge, asks to merge specific ready PRs, or…
git:20261010.76cfc50 · audit A · 14 stars
worktree-create SKILL.md skill
figelwump/toastty · examples/skills/worktree-create/SKILL.md · Create a named Toastty task workspace and Git worktree, nested as a task space under the current session, for planning…
git:20261018.8b14e79 · audit A · 14 stars
worktree-done SKILL.md skill
figelwump/toastty · examples/skills/worktree-done/SKILL.md · Use when the user says they are done reviewing or testing this worktree or task space and want its pull request merged…
git:20261017.9a6a8fd · audit A · 14 stars
toastty-capabilities SKILL.md skill
figelwump/toastty · plugins/toastty/skills/toastty-capabilities/SKILL.md · Use this skill when a user asks an agent to orchestrate, inspect, automate, control, coordinate, or present work inside…
git:20261018.8b14e79 · audit A · 14 stars
toastty-open-markdown SKILL.md skill
figelwump/toastty · plugins/toastty/skills/toastty-open-markdown/SKILL.md · Use this skill when you want to show the user a markdown file in Toastty for review, such as a plan, design doc, or…
git:20260802.e89d458 · audit A · 14 stars

Every file in figelwump/toastty

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