arena-cli_skill

Overview

This skill provides a lightweight CLI for exporting, enriching, and browsing Are.na blocks locally. It automates incremental exports, enriches images with vision AI metadata (titles, tags, UI patterns), and generates browsable HTML views and visual search pages. Use it to build a searchable, visual archive of Are.na content for design research or pattern discovery.

How this skill works

The CLI exports channel blocks into a local folder as per-block JSON, optionally downloading images for offline use. A vision enrichment step calls an AI image model to add suggested_title, description, tags, and ui_patterns to each image block. Finally, generator scripts build static HTML views and grouped visual search pages so you can inspect results in a browser when terminal grep is insufficient.

When to use it

• Export channels to a local archive or perform incremental updates
• Enrich image blocks with AI-generated titles, tags, and UI patterns
• Generate browsable HTML views of your Are.na export
• Run visual searches that produce image-grid results for quick inspection
• Search blocks by tag or UI pattern when exploring design systems or inspiration

Best practices

• Store ARENA_TOKEN, ARENA_USER_SLUG, and GEMINI_API_KEY in a .env file before running any script
• Run full export once, then use incremental exports for regular updates to avoid re-downloading everything
• Use --images only when you need local copies; skip for faster exports without images
• Run enrich step with --dry-run first to preview changes before saving, and use --force to reprocess as needed
• Group related search patterns into a config file for consistent visual search pages

Example use cases

• Build a local, searchable archive of UI screenshots for a product design library
• Automatically tag and title image blocks to speed up team discovery and reuse
• Generate a browsable view.html to share a curated collection with stakeholders offline
• Run pattern-based visual searches (e.g., dashboards, avatars) to gather inspiration grids
• Combine grep-based tag searches with generated search-results.html when terminal output can’t show images