donghaozhang/video-agent-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
FAQ
No—by default the skill creates symlinks to originals. It only copies files when symlinks are not possible. You can opt to copy explicitly if preferred.
Will this break project references?
The skill reports all planned moves before executing them. Always confirm actions that could alter paths used by other tools and update references if needed.
How does the hybrid symlink/copy system work?
The skill attempts to create symbolic links for imported media. If the OS or drive prevents symlinks, it falls back to copying and records importMethod in metadata.
3 skills
This skill organizes your project into QCut's standard structure, creating folders for media, skills, output, and docs to streamline setup and cleanup.
This skill exports, preprocesses, analyzes, fixes, and resolves PR review comments to streamline code-review workflows and improve feedback quality.
This skill helps you understand the project-docs structure, models, and CLI workflows to accelerate integration and debugging across the codebase.
