Index assets

Skill indranilbanerjee/socialforge/skills/index-assets

Open-source agency-grade social media production plugin — 16 skills, 25 commands, AI image (Nano Banana Pro) + AI video (Kling v3.0 Pro) + C2PA signing (EU AI Act Article 50). Installs on Claude Code, Cowork, Codex, Cursor, Copilot CLI, Antigravity. By Indranil Banerjee (indranil.in).

Install

npx -y skills add indranilbanerjee/socialforge --skill index-assets

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

22 stars22 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Index brand photo library using AI vision. Use when: setting up assets, adding new photos, or refreshing the index.

SKILL.md

4.0 KB, as published. Nobody here has run it

/socialforge:index-assets — Asset Indexer

Scan a brand's photo library and create an AI-powered asset index. Each image is analyzed by Gemini Vision to understand what's in it, what mood it conveys, what posts it's suitable for, and how it can be cropped for different platforms.

Context efficiency

Asset-heavy skill. Grep before Read the asset catalog (${CLAUDE_PLUGIN_DATA}/<brand>/assets/index.json) — never list the asset directory. Reference generated images / videos by path, not by loading metadata. Brand profile loads once per session.

How It Works

Locate assets — Read asset-source.json for the brand's photo library location
Scan files — Find all .jpg, .jpeg, .png, .webp files in the source
AI analysis — For each image, use Gemini Vision (gemini-3-flash) to generate:
- Natural language description of the image
- Tags (categories, subjects, setting, mood)
- Dominant colors detected
- Lighting and composition assessment
- What types of social media posts this image suits
- Whether background is removable (for compositing)
- Platform crop feasibility (can this be cropped to 1:1, 4:5, 16:9 without losing key content?)
Build index — Create asset-index.json with all analyzed assets
Identify style references — Suggest 2-8 images as style reference candidates (best represent the brand's visual DNA)

Pre-Flight Check

Before indexing, verify:

Brand profile exists for the specified brand
Asset source is configured (Google Drive URL or local path)
If Google Drive: verify Drive MCP is connected or platform integration is available

If asset source is not configured:

⚠️ No asset source configured for brand "{brand}".
Run /socialforge:brand-setup --update {brand} to add an asset source.
Or provide a path now: /socialforge:index-assets {brand} --source local --path /path/to/photos

Progress Updates

[1/4] Scanning asset source...
  Found: 47 images (32 .jpg, 12 .png, 3 .webp)

[2/4] Analyzing images with AI Vision...
  Analyzed: 12/47 (25%) — ~3 min remaining
  Analyzed: 24/47 (51%) — ~2 min remaining
  Analyzed: 47/47 (100%) ✓

[3/4] Building asset index...
  Tags generated: 184 unique tags across 47 assets
  Platform crops: 47 images × 6 platforms = 282 crop assessments

[4/4] Identifying style reference candidates...
  Top 8 candidates selected based on visual consistency and quality

Output

Asset Index Complete: acme-corp
  Total assets: 47
  Categories: people (12), products (8), office (6), events (5), lifestyle (9), graphics (7)
  Background-removable: 23 assets (suitable for ANCHOR_COMPOSE mode)
  Style reference candidates: 8 images suggested

  Saved: ~/socialforge-workspace/brands/acme-corp/asset-index.json

Would you like to:
- Review style reference candidates? (I'll show all 8 with descriptions)
- Start monthly production? (/socialforge:new-month)
- Update specific assets? (/socialforge:index-assets --refresh)

Timeout & Fallback

Per-image AI analysis: 15-second timeout. If an image times out, mark as analysis_pending and continue.
Large libraries (100+ images): Process in batches of 20. Show progress after each batch.
If AI Vision is unavailable: Create basic index from file metadata only (dimensions, filename, folder) — flag as ai_analysis_missing.

Refresh Mode

/socialforge:index-assets [brand] --refresh

Only re-analyzes new or modified images since last index. Compares file timestamps with indexed_at in asset-index.json.

Cost Awareness

Each image analysis costs approximately $0.002-0.005 (Gemini Vision). For a 50-image library, expect ~$0.10-0.25 total.

Show estimated cost before starting: "Indexing 47 images will cost approximately $0.12 in Gemini Vision API calls. Proceed?"