.agents/skills/resolve-slate-issue/SKILL.md
Handle $ARGUMENTS.
Use this for one issue at a time when the goal is to prove, fix or classify the
issue, then comment directly on the issue. This combines task issue-first
execution with Slate Plan's live-source, issue-ledger, and Slate v2
verification discipline.
Fixes ... issue metadata line in the comment.gh issue comment ... --body-file ... for the final issue comment.95%+ after verification, close the issue after posting the
comment..tmp/slate-v2 source wins over issue-time assumptions..tmp/slate-v2 is already green for the issue flow, do not patch
code just to make a diff. Classify already-accounted, record evidence, and
comment with current verification..tmp/slate-v2 is red, add the smallest proof row first, fix the
real owner, then verify.plate-2 commands prove planning/docs state only. Slate behavior proof must
run in .tmp/slate-v2.gh issue view <number-or-url> -R udecode/slate --comments --json number,title,body,comments,labels,state,url
If the repo is not udecode/slate, resolve the repo from the URL or current
gh repo, then fetch the same fields.
video-transcripts before
implementation unless an existing cached transcript comment fully covers the
same normalized media URL..tmp/slate-v2Before editing:
.tmp/slate-v2 source, examples, tests, and routes that own
the issue..tmp/slate-v2 first.| State | Meaning | Action |
|---|---|---|
red-current | Current .tmp/slate-v2 still reproduces the issue. | Add proof row, fix, verify, then comment. |
already-accounted | Current .tmp/slate-v2 passes the issue flow, likely fixed by later commits or prior work. | No code change; verify, comment, close if confidence is 95%+. |
needs-manual-proof | Browser/device/IME proof cannot be honestly automated. | Run available supporting proof, ask a human to reproduce the exact flow, leave open, and do not overclaim. |
blocked | Required issue evidence, media, or tooling is inaccessible after a real attempt. | Do not comment as fixed. Report blocker. |
For red-current:
.tmp/slate-v2..tmp/slate-v2.95%+ confidence, close the issue after posting the
comment:gh issue close <number-or-url> -R udecode/slate
For already-accounted:
95%+, close the issue after posting the comment.For needs-manual-proof:
95-100% confidence line.Record exact commands with cwd.
Common Slate v2 gates:
cd .tmp/slate-v2
bun --filter slate-react typecheck
bun check
PLAYWRIGHT_BASE_URL=http://localhost:3100 bun playwright <test-file> --project=chromium --grep "<issue row>"
Use only the commands that fit the touched surface. If bun check fails for an
unrelated broad integration or local-environment reason, isolate the failure and
record why it does not block the issue comment.
Write the final comment to a temp file, then post it:
gh issue comment <number-or-url> -R udecode/slate --body-file <comment-file>
Use this format. Keep it concise. Omit **⚠️ Caveat** when there is no real
caveat.
🟢 95-100% confidence
| Phase | 🧪 Tests | 🌐 Browser |
| ---------- | ----------------------------------------- | ------------------------------ |
| Reproduced | 🔴 <failing proof or issue-current repro> | ✅ <browser/local repro> |
| Verified | 🟢 <passing proof> | ✅ <browser verified behavior> |
**🌐 Browser Check**
- Open `<exact route>`.
- Follow `<exact user flow>`.
- Confirm `<expected fixed/current behavior>`.
**✅ Outcome**
- <What now happens for the user.>
- <What no longer happens.>
**⚠️ Caveat**
- <Only real caveats: manual IME/device gap, already fixed by later commits, or partial browser coverage.>
**🏗️ Design**
- Chosen owner: <runtime/package/example owner>.
- Why not quick patch: <why a local workaround was wrong, or `N/A; already fixed in current v2`.>
- Why not broader change: <why a larger API/runtime change was unnecessary, if applicable.>
**🧪 Verified**
- `<command or browser proof>`
- `<command or browser proof>`
Status words:
🔴 only when a real failing proof was observed in this run or preserved
from the just-executed plan.✅ when evidence exists but the current checkout was already green.already-accounted, say that plainly in Outcome or Caveat; do not
fake red-green.95% if browser/device proof is partial or manual-only.🟢 95-100% confidence.Please reproduce the steps above on <browser/device/input method>; leave this open until that confirms the behavior.After commenting, answer with:
red-current -> fixed, already-accounted, or blockergh returns oneKeep it short.