Automates cleanup of old container images from DigitalOcean registries based on retention policies. Keeps last 10 tags for staging, 30 for production, always preserves :latest.
Automates cleanup of old container images from DigitalOcean registries based on retention policies. Keeps last 10 tags for staging, 30 for production, always preserves :latest.
/plugin marketplace add DarkMonkDev/WitchCityRope/plugin install darkmonkdev-witchcityrope-agents@DarkMonkDev/WitchCityRopeThis skill inherits all available tools. When active, it can use any tool Claude has access to.
Purpose: Clean up old container images to manage storage costs in DigitalOcean Container Registries.
When to Use:
When NOT to Use:
This skill is the ONLY registry cleanup procedure.
DO NOT duplicate registry cleanup automation in:
| Repository | Retention | Always Keep | Purpose |
|---|---|---|---|
witchcityrope-api-staging | 10 tags | :latest | Staging API images |
witchcityrope-web-staging | 10 tags | :latest | Staging Web images |
witchcityrope-api-production | 30 tags | :latest | Production API images |
witchcityrope-web-production | 30 tags | :latest | Production Web images |
| Repository | Retention | Always Keep | Purpose |
|---|---|---|---|
accounting-api | 30 tags | :latest | Production API (treat as production) |
accounting-web | 30 tags | :latest | Production Web (treat as production) |
Rationale:
Executable Script: execute.sh
# From project root - shows what WOULD be deleted
bash .claude/skills/registry-cleanup/execute.sh
Output: Shows repositories, tag counts, tags that would be deleted, estimated storage savings.
NO CHANGES MADE - Safe to run anytime.
# From project root - ACTUALLY DELETES old tags
bash .claude/skills/registry-cleanup/execute.sh --confirm
Output: Shows repositories, deletes old tags, reports actual deletions, storage freed.
DESTRUCTIVE - Tags deleted cannot be recovered.
curl and jq installed:latest tag (always preserved)--confirm flag usedbash execute.shbash execute.sh --confirm# Example: Save audit log
bash .claude/skills/registry-cleanup/execute.sh --confirm 2>&1 | tee registry-cleanup-$(date +%Y-%m-%d).log
🧹 Registry Cleanup - DRY RUN MODE
===================================
📊 Analyzing WitchCityRope Registry
-----------------------------------
Repository: witchcityrope-api-staging
Total tags: 25
Retention policy: 10 most recent
Tags to delete: 15
Keeping (10 newest + :latest):
✅ sha-abc123f (2025-11-22)
✅ sha-def456g (2025-11-21)
... (8 more)
✅ latest (protected)
Would delete (15 oldest):
🗑️ sha-xyz789h (2025-10-15)
🗑️ sha-uvw456i (2025-10-10)
... (13 more)
Estimated storage freed: ~350 MB
Repository: witchcityrope-web-staging
Total tags: 18
Retention policy: 10 most recent
Tags to delete: 8
Would delete (8 oldest):
🗑️ sha-rst234j (2025-10-18)
... (7 more)
Estimated storage freed: ~200 MB
📊 Summary
----------
Total repositories: 6
Total tags: 125
Tags to keep: 72
Tags to delete: 53
Estimated storage freed: ~850 MB
⚠️ DRY RUN - No changes made
ℹ️ Run with --confirm to actually delete tags
🧹 Registry Cleanup - CONFIRM MODE
===================================
⚠️ WARNING: This will DELETE old tags permanently!
... (same analysis as dry-run) ...
🗑️ Deleting tags from witchcityrope-api-staging...
Deleted: sha-xyz789h ✅
Deleted: sha-uvw456i ✅
... (13 more)
✅ Deleted 15 tags from witchcityrope-api-staging
... (repeat for other repositories) ...
📊 Summary
----------
Total repositories: 6
Total tags deleted: 53
Actual storage freed: ~850 MB
✅ Registry cleanup complete
:latest and :sha-XXXXXX tags:latest and :sha-XXXXXX tags:latestRecommended cron schedule:
# Every Sunday at 2 AM
0 2 * * 0 cd /home/chad/repos/witchcityrope && bash .claude/skills/registry-cleanup/execute.sh --confirm 2>&1 | tee -a /var/log/registry-cleanup.log
Monitor storage costs in DigitalOcean dashboard:
Error: User secrets not found or empty
Solution:
cd /home/chad/repos/witchcityrope/apps/api
dotnet user-secrets list | grep DigitalOcean:Token
If empty, set token:
dotnet user-secrets set "DigitalOcean:Token" "YOUR_TOKEN_HERE"
Error: 401 Unauthorized
Solution: Token may be expired or invalid. Generate new token:
Error: 404 Not Found or 500 Server Error
Solution:
Symptom: Tags deleted but storage usage unchanged
Explanation: DigitalOcean processes deletions asynchronously. Wait 1-2 hours for storage metrics to update.
Edit execute.sh to modify retention counts:
# Repository configurations (line ~80)
declare -A RETENTION
RETENTION["witchcityrope-api-staging"]=10 # Change to 5, 15, etc.
RETENTION["witchcityrope-web-staging"]=10
RETENTION["witchcityrope-api-production"]=30 # Change to 20, 50, etc.
RETENTION["witchcityrope-web-production"]=30
Consider:
Edit execute.sh to add new repositories:
# Repository configurations (line ~80)
RETENTION["new-service-staging"]=10
RETENTION["new-service-production"]=30
Skill automatically processes all configured repositories.
List Repository Tags:
curl -X GET \
-H "Authorization: Bearer $TOKEN" \
"https://api.digitalocean.com/v2/registry/witchcityrope/repositories/witchcityrope-api-staging/tags"
Delete Tag:
curl -X DELETE \
-H "Authorization: Bearer $TOKEN" \
"https://api.digitalocean.com/v2/registry/witchcityrope/repositories/witchcityrope-api-staging/tags/sha-abc123f"
Response Codes:
200 OK - List successful204 No Content - Delete successful401 Unauthorized - Invalid token404 Not Found - Repository/tag not found429 Too Many Requests - Rate limited (wait 60 seconds)For questions or issues: Consult DigitalOcean Container Registry documentation or raise issue in repository.
This skill should be used when the user asks to "create a slash command", "add a command", "write a custom command", "define command arguments", "use command frontmatter", "organize commands", "create command with file references", "interactive command", "use AskUserQuestion in command", or needs guidance on slash command structure, YAML frontmatter fields, dynamic arguments, bash execution in commands, user interaction patterns, or command development best practices for Claude Code.
This skill should be used when the user asks to "create an agent", "add an agent", "write a subagent", "agent frontmatter", "when to use description", "agent examples", "agent tools", "agent colors", "autonomous agent", or needs guidance on agent structure, system prompts, triggering conditions, or agent development best practices for Claude Code plugins.
This skill should be used when the user asks to "create a hook", "add a PreToolUse/PostToolUse/Stop hook", "validate tool use", "implement prompt-based hooks", "use ${CLAUDE_PLUGIN_ROOT}", "set up event-driven automation", "block dangerous commands", or mentions hook events (PreToolUse, PostToolUse, Stop, SubagentStop, SessionStart, SessionEnd, UserPromptSubmit, PreCompact, Notification). Provides comprehensive guidance for creating and implementing Claude Code plugin hooks with focus on advanced prompt-based hooks API.