organize-project_skill

Overview

This skill organizes files and folders into QCut's standard project structure to create a predictable workspace for video projects. It prepares media, skills, output, cache, and docs folders, and separates imported vs generated assets. Use it to set up new projects, clean a messy workspace, or enforce project conventions before export.

How this skill works

The skill scans the current directory tree, identifies media by extension and source, and creates the canonical QCut layout (media/{imported,generated,temp}, skills, output, cache, docs). It prefers creating symlinks for imported media and falls back to copying when symlinks are unavailable. The skill updates import metadata and reports all changes so you can confirm moves that might affect project references.

When to use it

• Setting up a new QCut project workspace
• Cleaning and standardizing an existing project folder
• Importing large batches of media while preserving originals
• Preparing a project for rendering or sharing
• After running AI skills to segregate generated content

Best practices

• Scan and review file classification results before making changes
• Prefer symlinks to save disk space; allow copy fallback on restricted systems
• Keep AI-generated assets in media/generated and user files in media/imported
• Name exports descriptively: {project-name}_{date}_{resolution}.mp4
• Clean media/temp and cache after export to reclaim space
• Avoid moving files without confirming linked project references

Example use cases

• Initialize Documents/QCut/Projects/MyFilm with the standard folder tree and sample project.qcut
• Import a folder of raw footage: create symlinks in media/imported and record import metadata
• Segregate AI outputs from manual assets by moving generated clips to media/generated
• Run cleanup: remove empty directories, clear media/temp and cache after a successful export
• Prepare a project for delivery by moving final renders to output with descriptive filenames