angora-media

Media

Process images from the inbox/ directory into the media system.

Before you start

1. Check inbox contents — list inbox/ directory. If empty (only .gitkeep), report "Inbox is empty. Drop images into inbox/ and run this again."
2. Check current media table — run:

node -e "
  import db from './src/data/db.ts';
  import { media } from './src/data/schema/tables/media.ts';
  const rows = db.select().from(media).all();
  console.table(rows);
"

Pipeline (for each image)

1. Visual analysis

Read the image file with the Read tool (Claude vision). Write alt text:

• Describe what's in the image, under 125 characters
• Don't start with "Image of" or "Photo of"
• Use alt="" for purely decorative images (backgrounds, dividers)

2. Read dimensions

node -e "
  import { imageSize } from 'image-size';
  const result = imageSize('inbox/<filename>');
  console.log(JSON.stringify(result));
"

Skip for SVGs (scalable — dimensions not meaningful).

3. Generate unique filename

node -e "
  import { nanoid } from 'nanoid';
  console.log(nanoid(8));
"

Preserve the original extension. Result: V1StGXR8.jpg

4. Move file

mv inbox/<original> public/media/<nanoid>.<ext>

5. Insert into media table

node -e "
  import db from './src/data/db.ts';
  import { media } from './src/data/schema/tables/media.ts';
  db.insert(media).values({
    path: 'media/<nanoid>.<ext>',
    alt: '<alt text>',
    type: 'image',
    width: <width>,
    height: <height>,
    sourceName: '<original filename>',
  }).run();
  console.log('Inserted.');
"

6. Summary table

After processing all images, show a summary:

Original	New path	Dimensions	Alt text
hero-bg.jpg	media/V1StGXR8.jpg	1920x1080	Dark gradient background with subtle grid pattern

Rules

• Supported types: jpg, jpeg, png, gif, webp, avif, svg
• SVGs: skip dimension reading (scalable), set type to svg
• Never delete inbox files without explicit permission — ask after processing
• Skip non-image files — report them: "Found non-image files: [list]. These can be processed with the import skill (/angora-import)."
• Process images one at a time to ensure accuracy of alt text