screenshot-argus — read, act, delete
The user drops screenshots in one folder. You read them, act, then delete the
ones you read. The folder is a mailbox, not an archive.
The directory
Read .screenshot-dir at the repo root — one line, an absolute path.
If it does not exist, ask the user for the path once, then write their answer
to .screenshot-dir — not a placeholder, the path they actually gave you:
<absolute path the user gave you>
If the user gives a path in their message, that wins for this cycle, and write
it to .screenshot-dir if the file is missing or points somewhere else (ask
before overwriting an existing different path).
No one to ask, and no .screenshot-dir? Say so in one line and stop — never guess
a folder. A folder you found yourself (a screenshots/ at the root, Desktop,
Downloads) is a guess: do not open, read, act on or delete any file in it. Reading
it is already the breach; fixing what it shows is not a safe middle path. "Go
ahead" / "don't ask" lets you skip questions, not pick the folder.
Same if the file points somewhere other than a path you were given: use the
given path for this cycle and leave .screenshot-dir as it is.
The cycle
- List — glob the directory for
*.png *.jpg *.jpeg *.webp *.gif, sorted
oldest first. Empty? Say so in one line and stop. Do not go looking elsewhere.
- Read every one with the Read tool. Every one, not a sample. Screenshot 4
is usually the one that explains screenshots 1–3.
- Understand before acting. State in 1–3 lines what the set shows: the
screen, what is wrong or being asked for, and which files that maps to. If
the screenshots are ambiguous — you cannot tell what the user wants changed —
ask, and do not delete anything.
- Act. Make the fix or the change. This is normal work: find the code,
edit it, run the check. Screenshots are the bug report, not the task list —
if two of them show the same defect, that is one fix.
- Verify the way the project normally verifies (tests, build, run). If the
change cannot be verified, say so plainly.
- Delete — and only now — exactly the files listed in step 1, by name.
Files that appeared mid-cycle are next cycle's input; leave them.
- Report: what the screenshots showed, what changed, what was deleted.
Deletion rules
- Delete files, never the directory itself.
- Delete only after the work is done and reported. Work blocked, question
pending, or user interrupted → screenshots stay.
- Never delete anything outside the screenshot directory.
- If the user says "keep them" or "don't delete", skip step 6 and say so.
Repeat rounds
The user will drop a new batch and say "again" / "recheck" / "still broken".
Run the cycle again from step 1. Carry what you learned last round — a second
round of the same screen means the first fix missed, so investigate rather than
re-applying the same edit.
1---2name: screenshot-argus3description: >-4 Use when the user says "screenshots", "check the screenshots", "I dropped5 new screenshots", "test screenshots", "look at the latest run", or gives a6 screenshot directory path — test screenshots dropped in a project's7 screenshot folder that need acting on and then clearing. NOT for taking8 screenshots (use a browser/app skill for that) and NOT for permanent design9 assets — everything in that folder is treated as disposable.10metadata:11 source: https://skillmd.com/skills/bodish-coder/screenshot-argus12---1314# screenshot-argus — read, act, delete1516The user drops screenshots in one folder. You read them, act, then delete the17ones you read. The folder is a mailbox, not an archive.1819## The directory2021Read `.screenshot-dir` at the repo root — one line, an absolute path.2223If it does not exist, ask the user for the path once, then write their answer24to `.screenshot-dir` — not a placeholder, the path they actually gave you:2526```27<absolute path the user gave you>28```2930If the user gives a path in their message, that wins for this cycle, and write31it to `.screenshot-dir` if the file is missing or points somewhere else (ask32before overwriting an existing different path).3334No one to ask, and no `.screenshot-dir`? Say so in one line and stop — never guess35a folder. A folder you found yourself (a `screenshots/` at the root, Desktop,36Downloads) is a guess: do not open, read, act on or delete any file in it. Reading37it is already the breach; fixing what it shows is not a safe middle path. "Go38ahead" / "don't ask" lets you skip questions, not pick the folder.39Same if the file points somewhere other than a path you were given: use the40given path for this cycle and leave `.screenshot-dir` as it is.4142## The cycle43441. **List** — glob the directory for `*.png *.jpg *.jpeg *.webp *.gif`, sorted45 oldest first. Empty? Say so in one line and stop. Do not go looking elsewhere.462. **Read every one** with the Read tool. Every one, not a sample. Screenshot 447 is usually the one that explains screenshots 1–3.483. **Understand before acting.** State in 1–3 lines what the set shows: the49 screen, what is wrong or being asked for, and which files that maps to. If50 the screenshots are ambiguous — you cannot tell what the user wants changed —51 ask, and do not delete anything.524. **Act.** Make the fix or the change. This is normal work: find the code,53 edit it, run the check. Screenshots are the bug report, not the task list —54 if two of them show the same defect, that is one fix.555. **Verify** the way the project normally verifies (tests, build, run). If the56 change cannot be verified, say so plainly.576. **Delete** — and only now — exactly the files listed in step 1, by name.58 Files that appeared mid-cycle are next cycle's input; leave them.597. **Report**: what the screenshots showed, what changed, what was deleted.6061## Deletion rules6263- Delete files, never the directory itself.64- Delete only after the work is done and reported. Work blocked, question65 pending, or user interrupted → screenshots stay.66- Never delete anything outside the screenshot directory.67- If the user says "keep them" or "don't delete", skip step 6 and say so.6869## Repeat rounds7071The user will drop a new batch and say "again" / "recheck" / "still broken".72Run the cycle again from step 1. Carry what you learned last round — a second73round of the same screen means the first fix missed, so investigate rather than74re-applying the same edit.