# File Upload Orchestrator

> Orchestrates file uploads with progress tracking, chunking, resumable uploads, and validation. Supports S3, GCS, and local storage.

- Skill: `fadil369/file-upload-orchestrator` (Agent Skill)
- Install (CLI): `npx skillmds@latest add fadil369/file-upload-orchestrator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/fadil369/file-upload-orchestrator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: fadil369 (https://skillmd.com/u/fadil369)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/fadil369/file-upload-orchestrator

---


# File Upload Orchestrator

Orchestrates file uploads with progress tracking, chunking, resumable uploads, and validation. Supports S3, GCS, and local storage.

## Decision Framework

### When to Apply
Use when: File uploads > 10MB, bulk uploads, drag-and-drop, resumable uploads needed, progress tracking

### When NOT to Apply
Don't use when: Small single-file inputs (< 1MB), simple avatar uploads

## Anti-Patterns

### 1. No File Type Validation
```javascript
// BAD: Accepts anything
upload(file);

// GOOD: Validate type and size
const allowed = ['image/jpeg', 'image/png', 'application/pdf'];
if (!allowed.includes(file.type)) throw new Error('File type not allowed');
if (file.size > 10 * 1024 * 1024) throw new Error('File too large (max 10MB)');
```

### 2. Unlimited File Sizes
Always enforce size limits to prevent DoS.


## Trigger Phrases

- "File upload"
- "Drag and drop upload"
- "Chunked upload"
- "Upload progress"
- "Resumable upload"

## Patterns

### Chunked Upload
```javascript
class ChunkedUploader {
  constructor(file, options = {}) {
    this.file = file;
    this.chunkSize = options.chunkSize || 5 * 1024 * 1024; // 5MB
    this.concurrency = options.concurrency || 3;
  }

  async upload(onProgress) {
    const chunks = this.createChunks();
    const uploadId = await this.initUpload();
    let uploaded = 0;

    for (let i = 0; i < chunks.length; i += this.concurrency) {
      const batch = chunks.slice(i, i + this.concurrency);
      await Promise.all(batch.map(async (chunk, idx) => {
        await this.uploadChunk(uploadId, i + idx, chunk);
        uploaded++;
        onProgress?.({ loaded: uploaded, total: chunks.length });
      }));
    }

    return this.completeUpload(uploadId);
  }

  createChunks() {
    const chunks = [];
    for (let offset = 0; offset < this.file.size; offset += this.chunkSize) {
      chunks.push(this.file.slice(offset, offset + this.chunkSize));
    }
    return chunks;
  }
}
```

## Integration
- Works with: performance-budget-enforcer, error-recovery-orchestrator, notification-system-builder