chess-teacher-storage

Inspect S3-compatible object storage keys, prefixes, and existence checks read-only.

1|Updated Apr 30, 2026
One-click install
npx skills add https://github.com/daniel-brus/chess_teacher --skill chess-teacher-storage-daniel-brus
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: chess-teacher-storage
Source: https://github.com/daniel-brus/chess_teacher/tree/main/.agents/skills/chess-teacher-storage
Command: npx skills add https://github.com/daniel-brus/chess_teacher --skill chess-teacher-storage-daniel-brus

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? It answers questions about what files and folders exist in the chess_teacher project's S3 or MinIO object storage without risking any modification, since all operations are strictly read-only. ## Core Features & Use Cases - Key and Prefix Listing: List object keys under any prefix with suffix, glob, recursion, and limit filters, plus immediate folder-style children views. - Existence and Count Checks: Verify whether a single object key exists, whether any objects live under a prefix, and how many keys match. - Backend Inspection: Show the configured backend, storage root, bucket, and endpoint, with Doppler configs for local MinIO (dev_local) or production S3 (prod). - Use Case: When a user asks "what's under ingested/acct?" or "does processed/acct/file.jsonl exist?", the agent runs the storage_query.py script and interprets the JSON output in plain language. ## Quick Start Ask the agent to list what files exist under a storage prefix such as ingested/acct, and it will run the read-only storage query script and summarize the results.

Frequently Asked Questions about chess-teacher-storage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list files in S3 object storage by prefix?▼

Run the storage_query.py script with the list command and a prefix, optionally adding --suffix, --glob, --no-recursive, or --limit filters. It returns JSON with matching keys relative to the configured storage root.

How to check if an S3 object key exists in Python?▼

Use the exists command, which calls ObjectStorage.read_bytes on the key and reports exists: true when the object is present. For checking whether a folder-like prefix exists, use any-under instead.

Does this work with MinIO as well as AWS S3?▼

Yes, it works with any S3-compatible backend configured through the S3_* environment variables. Local development uses MinIO via the dev_local Doppler config, while production uses external S3 via the prod config.

Can this skill modify or delete objects in storage?▼

No, it is strictly read-only and only uses list_keys and read_bytes. The only exception is the health command, which writes and deletes a temporary _healthcheck probe object and should only run when explicitly requested.

Why does list return empty results for a prefix?▼

Empty results usually mean the prefix is wrong, since keys have no leading slash and are relative to STORAGE_ROOT. Try the children command on the parent prefix to discover the actual sub-prefix names.