Skill: ethagent/file (version 1.0.0)

--- name: File description: A comprehensive AI agent skill for managing the files, folders, and documents that accumulate across your digital life. Organizes chaos into clarity, builds naming systems that actually work, finds things you cannot locate, manages documents across projects, and maintains the kind of organized digital environment that makes work feel less like archaeology. --- # File ## The Desktop You Have Been Ignoring There is a desktop somewhere — possibly yours — that has not been organized since the computer was new. It contains screenshots with names like "Screen Shot 2023-04-17 at 11.43.22 AM," documents called "final," "final2," "final_ACTUAL," and "final_USE_THIS_ONE," folders with names that made sense at the time and now mean nothing, and files that could be deleted but might be important and so have remained, accumulating alongside everything else, for years. This is not a character flaw. It is what happens when the friction of organizing files in the moment consistently exceeds the friction of ignoring them. Every individual decision to save something without naming it properly is rational given the time pressure of that specific moment. The problem is entirely in the aggregate — the compounding cost of thousands of small rational decisions that together produce an environment nobody would have chosen. The skill does not judge the desktop. It fixes it. --- ## The Naming Problem Most file chaos begins with naming. Not because people are careless but because good file naming requires thinking about the future at a moment when you are focused on the present. You save the document quickly because you need to get back to the meeting. You name the photo by the date your camera assigned it because renaming takes time you do not have. You call the draft "draft" because you intend to rename it when it is finished, and then you never do. The skill builds a naming system that works with how you actually save files rather than against it. It starts with your specific situation — what kinds of files you work with most, what projects or areas of your life generate the most documents, how you tend to search for things when you cannot find them — and builds conventions from there. Good naming conventions share certain properties regardless of context. They are specific enough that the name tells you what the file contains without opening it. They include dates in a format that sorts chronologically. They distinguish versions in a way that makes the current version immediately obvious. They use words you would actually type when searching rather than words that seemed logical when saving. The skill generates specific naming conventions for your specific file types and teaches them through the files you actually have rather than abstract examples. --- ## Building a Folder Structure That Lasts The folder structure most people have grew organically over years of adding things without a plan. The result is a hierarchy that reflects the order in which things were created rather than any logic about how they relate to each other or how they will be needed later. A folder structure built with intention works differently. It is organized around how you retrieve files, not how you create them. It has a depth that is shallow enough that nothing requires more than three or four clicks to find, and consistent enough that you always know roughly where something should be without having to remember exactly where you put it. The skill helps you design this structure from scratch or reorganize the one you have. It asks how you work, what projects and areas of your life generate the most files, and what you are typically trying to find when you search. It builds a structure from those answers and proposes exactly what moves where before anything is changed. Nothing is moved without your review and approval. The plan is shown in full first. You adjust what needs adjusting. Then and only then does anything change. --- ## Finding What You Cannot Find The file you need right now is somewhere. You know it exists. You remember creating it, or receiving it, or downloading it. You have searched for it twice and found something similar but not the thing itself. You have three minutes before the meeting where you need it. The skill retrieves files through natural language description. You describe what you remember about the file — its approximate content, when you created or received it, what project it was associated with, what format it was in, any fragment of the name you can recall — and the skill constructs the most targeted search possible from those details. It also helps you after the fact, once the crisis has passed, to figure out why the file was hard to find and how to ensure that the next file like it is findable in seconds rather than minutes. The retrieval problem is almost always a naming or organization problem in disguise. --- ## Project File Management Every project generates files: drafts, research, assets, communications, contracts, invoices, deliverables in various stages of completion. Without a consistent structure, project folders become the same kind of archaeological site as the desktop — except that the files in a project folder are actively in use, which means the cost of disorganization is immediate rather than deferred. The skill establishes a consistent project folder structure that works across every project you run. The same categories in the same places regardless of the project's content: a place for working documents, a place for reference material, a place for assets, a place for deliverables, a place for communications. A naming convention that makes the current version of every deliverable immediately obvious and keeps version history without creating confusion about which file to open. When a project is complete, the skill helps you archive it cleanly — compressing what should be preserved, deleting what should not, and ensuring that the archived project is findable a year later when a client asks a question about something you delivered and you need to reconstruct the context. --- ## The Inbox Zero of Files Email has inbox zero as a concept — the idea that an empty inbox is a processed inbox, a system where everything has been handled rather than deferred. Files need the equivalent. The Downloads folder is where files go to be forgotten. The Desktop is where files go when there is no time to put them anywhere properly. The skill helps you process these accumulation points regularly: everything in Downloads either filed, deleted, or consciously deferred with a note about why. The Desktop cleared to the point where every item present is present intentionally. This is not about perfection. It is about the difference between a system that runs and a system that accumulates debt. A file environment that is processed regularly stays manageable. One that is never processed requires an excavation every time you need something. --- ## Digital Documents That Matter Some files are not just files. They are records — contracts, tax documents, medical records, financial statements, legal correspondence — whose loss or inaccessibility has real consequences. The skill helps you identify which documents in your possession fall into this category and ensures they are stored, named, and backed up in a way that makes them accessible when they are needed, which is usually urgently and under pressure. It builds a simple inventory of your critical documents — what they are, where they are stored, and when they expire or need to be renewed — so that you are never in the situation of needing a document and not knowing whether you have it. --- ## Maintenance Without Effort An organized file system does not stay organized by itself. It stays organized because the habits that built it are lightweight enough to sustain — because filing something correctly takes ten seconds rather than ten minutes, because the structure is clear enough that there is never a real question about where something belongs, because the occasional cleanup is a thirty-minute task rather than a weekend project. The skill helps you build and maintain these habits. A weekly five-minute review of the Downloads folder. A project closeout routine that takes fifteen minutes and leaves nothing behind. A quarterly review of folders that tend to accumulate things that should be elsewhere. The goal is not a perfect system. It is a system that requires so little effort to maintain that you actually maintain it.


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)