Skill: keep the project tidy

The operating skill gains "Keep the project tidy": reuse before creating,
track the IDs a task creates and delete its drafts, superseded playlists,
replaced uploads, test apps, check webhooks and abandoned operations before
finishing, delete a playlist before the media only it used, remove only
what the task created or the user names, and report what was removed.

operations.md gains "Cleaning up" with the delete commands and their
refusals (a playlist any screen still uses, archived included; media and
apps a screen shows; screen delete only when deletable). commands.md lists
app delete. The dashboard-image skill deletes the media a refresh replaced.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Author: gersham

plugins/screenrig/skills/screenrig-dashboard/SKILL.md

@@ -67,4 +67,6 @@ existing [screenrig skill](../screenrig/SKILL.md). Use its bundled
 normal playlist workflow. The output is already lossy delivery WebP, so avoid a
 second encoding pass. Preserve unrelated playlist content. Follow that skill's
 project, target, retry, and playback-verification rules. A local image is not
-proof of publication or physical display.
+proof of publication or physical display. On a refresh, once the new image is playing,
+delete the media it replaced so the project does not fill with old renders
+(see [cleaning up](../screenrig/references/operations.md#cleaning-up)).

plugins/screenrig/skills/screenrig/SKILL.md

@@ -665,6 +665,24 @@ no SDK call, `log()` included, while `readyState` is not `active`; see
 [SDK startup](references/applications.md#start-the-sdk-in-this-order). The [command inventory](references/commands.md)
 provides a compact reference for supported operations.
 
+## Keep the project tidy
+
+The project is the customer's account: leave only what they asked for.
+
+- Reuse before creating: update the existing playlist rather than adding one
+  per revision, and rerun an interrupted upload, which returns its media.
+  Tag a task's uploads.
+- Track the IDs you create. Before finishing, delete drafts, superseded
+  playlists, test or replaced uploads, rejected generations, test apps, check
+  webhooks and abandoned operations.
+- Delete a playlist before the media and apps only it used: media and app
+  deletes check only what screens show now. A playlist delete is refused while
+  any screen, archived included, uses it; reassign that screen first.
+- Remove only what you created in this task or what the user names; ask before
+  deleting anything else. Report what you created and removed, with IDs.
+
+See [cleaning up](references/operations.md#cleaning-up).
+
 ## Resolve issues and ask for support
 
 Own diagnosis and resolution for the user: inspect the actual error and current

plugins/screenrig/skills/screenrig/references/commands.md

@@ -232,6 +232,7 @@ app update <id> <directory> [--expect-rev REVISION] [--no-wait] [--poll-ms MS]
 app rename <id> --name NAME [--expect-rev REVISION]
 app list
 app show <id>
+app delete <id> [--expect-rev REVISION]
 media generate (--prompt TEXT | --prompt-file FILE) [--aspect-ratio RATIO] [--quality low|medium|high] [--tag TAG]
                 [--no-progress]
 media upload <file> [--content-type TYPE] [--tag TAG] [--no-wait] [--poll-ms MS]

plugins/screenrig/skills/screenrig/references/operations.md

@@ -414,3 +414,25 @@ the user; do not create replacement conversations to bypass their human request.
 
 End a resolved conversation with `support close --conversation-id ID`. Its history
 remains readable; staff can reopen it. Start a new conversation for a new issue.
+
+## Cleaning up
+
+```bash
+screenrig screen assign scr_SCREEN --playlist-id pl_KEEP
+screenrig playlist delete pl_OLD
+screenrig media delete med_OLD
+screenrig app delete app_OLD
+screenrig screen archive scr_TEST
+screenrig operations cancel op_ABANDONED
+screenrig invitations revoke inv_UNUSED
+screenrig webhooks delete whk_CHECK
+```
+
+`playlist delete` is refused while any screen, archived or pending included,
+assigns, schedules or takes over with it. `media delete` and `app delete` (every
+release; `application_in_use`) are refused while a screen shows the item, not
+while another playlist references it: check with `playlist show` first. On a
+recurring refresh, delete the replaced media once the new one plays; on
+`resource_conflict`, retry at the next refresh. `screen delete` works only when
+`screen show` reports `deletable: true`; otherwise archive. Delete local renders and previews you wrote unless the user
+wants them.

skills/screenrig-dashboard/SKILL.md

@@ -67,4 +67,6 @@ existing [screenrig skill](../screenrig/SKILL.md). Use its bundled
 normal playlist workflow. The output is already lossy delivery WebP, so avoid a
 second encoding pass. Preserve unrelated playlist content. Follow that skill's
 project, target, retry, and playback-verification rules. A local image is not
-proof of publication or physical display.
+proof of publication or physical display. On a refresh, once the new image is playing,
+delete the media it replaced so the project does not fill with old renders
+(see [cleaning up](../screenrig/references/operations.md#cleaning-up)).

skills/screenrig/SKILL.md

@@ -665,6 +665,24 @@ no SDK call, `log()` included, while `readyState` is not `active`; see
 [SDK startup](references/applications.md#start-the-sdk-in-this-order). The [command inventory](references/commands.md)
 provides a compact reference for supported operations.
 
+## Keep the project tidy
+
+The project is the customer's account: leave only what they asked for.
+
+- Reuse before creating: update the existing playlist rather than adding one
+  per revision, and rerun an interrupted upload, which returns its media.
+  Tag a task's uploads.
+- Track the IDs you create. Before finishing, delete drafts, superseded
+  playlists, test or replaced uploads, rejected generations, test apps, check
+  webhooks and abandoned operations.
+- Delete a playlist before the media and apps only it used: media and app
+  deletes check only what screens show now. A playlist delete is refused while
+  any screen, archived included, uses it; reassign that screen first.
+- Remove only what you created in this task or what the user names; ask before
+  deleting anything else. Report what you created and removed, with IDs.
+
+See [cleaning up](references/operations.md#cleaning-up).
+
 ## Resolve issues and ask for support
 
 Own diagnosis and resolution for the user: inspect the actual error and current

skills/screenrig/references/commands.md

@@ -232,6 +232,7 @@ app update <id> <directory> [--expect-rev REVISION] [--no-wait] [--poll-ms MS]
 app rename <id> --name NAME [--expect-rev REVISION]
 app list
 app show <id>
+app delete <id> [--expect-rev REVISION]
 media generate (--prompt TEXT | --prompt-file FILE) [--aspect-ratio RATIO] [--quality low|medium|high] [--tag TAG]
                 [--no-progress]
 media upload <file> [--content-type TYPE] [--tag TAG] [--no-wait] [--poll-ms MS]

skills/screenrig/references/operations.md

@@ -414,3 +414,25 @@ the user; do not create replacement conversations to bypass their human request.
 
 End a resolved conversation with `support close --conversation-id ID`. Its history
 remains readable; staff can reopen it. Start a new conversation for a new issue.
+
+## Cleaning up
+
+```bash
+screenrig screen assign scr_SCREEN --playlist-id pl_KEEP
+screenrig playlist delete pl_OLD
+screenrig media delete med_OLD
+screenrig app delete app_OLD
+screenrig screen archive scr_TEST
+screenrig operations cancel op_ABANDONED
+screenrig invitations revoke inv_UNUSED
+screenrig webhooks delete whk_CHECK
+```
+
+`playlist delete` is refused while any screen, archived or pending included,
+assigns, schedules or takes over with it. `media delete` and `app delete` (every
+release; `application_in_use`) are refused while a screen shows the item, not
+while another playlist references it: check with `playlist show` first. On a
+recurring refresh, delete the replaced media once the new one plays; on
+`resource_conflict`, retry at the next refresh. `screen delete` works only when
+`screen show` reports `deletable: true`; otherwise archive. Delete local renders and previews you wrote unless the user
+wants them.