---

name: masonry description: AI-powered image and video generation using the Masonry CLI. Generate images, videos, check job status, and manage media assets. metadata: author: masonry-ai version: "1.0" compatibility: Requires masonry CLI installed (curl -sSL https://media.masonry.so/cli/install.sh | sh) allowed-tools: Bash(masonry:*)

Masonry CLI

The masonry CLI provides AI-powered image and video generation capabilities.

When to use this skill

Use this skill when the user wants to:

• Generate images from text prompts
• Generate videos from text prompts
• Check status of generation jobs
• Download generated media
• List available AI models
• View generation history

Installation

If the masonry command is not available, install it:

curl -sSL https://media.masonry.so/cli/install.sh | sh

Quick Commands

# Generate image
masonry image "your prompt here" --aspect 16:9

# Generate video
masonry video "your prompt here" --duration 4

# Check job status
masonry job status <job-id>

# Download result
masonry job download <job-id> -o ./output.png

# List available models
masonry models list --type image
masonry models list --type video

Detailed Workflows

Image Generation

# Basic generation
masonry image "a sunset over mountains, photorealistic"

# With options
masonry image "cyberpunk cityscape" --aspect 16:9 --model imagen-3.0-generate-002

# Available flags
#   --aspect, -a     Aspect ratio (16:9, 9:16, 1:1)
#   --dimension, -d  Exact size (1920x1080)
#   --model, -m      Model key
#   --output, -o     Output path
#   --negative-prompt What to avoid
#   --seed           Reproducibility seed

Video Generation

# Basic generation
masonry video "ocean waves crashing on rocks"

# With options
masonry video "drone shot of forest" --duration 6 --aspect 16:9

# Available flags
#   --duration       Length in seconds (4, 6, 8)
#   --aspect, -a     Aspect ratio (16:9, 9:16)
#   --model, -m      Model key
#   --image, -i      First frame image
#   --no-audio       Disable audio generation

Job Management

# List recent jobs
masonry job list

# Check specific job
masonry job status <job-id>

# Wait for completion and download
masonry job wait <job-id> --download -o ./result.png

# View local history
masonry history list
masonry history pending --sync

Model Discovery

# List all models
masonry models list

# Filter by type
masonry models list --type video

# Get model parameters
masonry models params veo-3.1-fast-generate-preview

Response Format

All commands return JSON:

{
  "success": true,
  "job_id": "abc-123",
  "status": "pending",
  "check_after_seconds": 10,
  "check_command": "masonry job status abc-123"
}

Authentication

If commands fail with auth errors:

masonry login

Enhanced Project Skills

For project-specific skills with detailed workflows, run:

masonry skill install

This installs additional skills to .claude/skills/:

• masonry-generate - Detailed generation workflow
• masonry-models - Model exploration
• masonry-jobs - Job management