local-media-cataloger

What This Skill Does

The Local Media Cataloger is a sophisticated organizational agent designed to bring order to chaotic file systems. By scanning directories, it indexes your creative assets—including photos, videos, and design files—into a structured manifest. It extracts technical metadata such as file extensions, timestamps, resolutions, and file sizes to create a searchable database. Beyond mere indexing, the skill helps you curate your media by flagging near-duplicates using heuristic analysis, suggesting professional folder structures for archival and production, and brainstorming creative reuse opportunities for your existing footage or imagery. It serves as your personal digital asset management (DAM) assistant, ensuring that your raw materials are always accessible and production-ready.

Installation

To integrate this skill into your OpenClaw environment, ensure you have the core agent framework installed. Execute the following command in your terminal:

clawhub install openclaw/skills/skills/52yuanchangxing/local-media-cataloger

Once installed, the skill will automatically link the necessary Python scripts and metadata schemas from the source repository. No additional environment variables are required, as the skill operates locally on your machine, leveraging the bundled media_manifest.py and metadata_schema.json files for immediate execution.

Use Cases

• Production Cleanup: Organize raw footage from a specific shoot into a standardized "Selects," "Exports," and "Archive" hierarchy after a long day of filming.
• Content Repurposing: Scan a local archive of photos to identify older high-quality assets that can be retagged or resized for a modern social media campaign.
• Storage Management: Identify and prune near-duplicate image files taking up excessive space on your hard drive before initiating a cloud backup.
• Workflow Standardization: Enforce consistent file naming and tagging conventions across a team by applying a predefined metadata schema to all new creative projects.

Example Prompts

• "catalog my media folder at /Volumes/SSD/Production_2023, use the standard creative schema, and suggest a folder structure for these assets."
• "摄影素材归档: 整理文件夹 D:\Photography\SummerTrip, 帮我找出重复的照片并按拍摄日期生成一份清单。"
• "I have a folder of raw video clips. Please scan them, flag any potential duplicates, and provide ideas for how I could reuse these shots in a highlight reel."

Tips & Limitations

• Preview First: Always treat the generated manifest as a draft. The skill is designed to provide actionable suggestions, not to modify your file system automatically. Review the proposed folder plans before committing to physical file moves.
• Metadata Accuracy: The quality of the indexing depends on the embedded metadata of your files. Files lacking EXIF or XMP data will be indexed based on filesystem timestamps (created/modified).
• Boundaries: This skill operates strictly within the boundaries of your local filesystem. It will not perform destructive operations, send files to the cloud, or make legal claims regarding your assets. If you encounter missing information, simply provide the missing context (e.g., project name or naming preference) to refine the output.