civitai-orchestration

Name: civitai-orchestration
Author: civitai

github.com/civitaiData & databases7.3k60 installsUpdated today

About civitai-orchestration

A skill for querying the Civitai Orchestration API, for users inspecting workflows, jobs, and generation results. It supports searches by tags, metadata, and dates, and can view or download outputs such as images and videos.

Key features

01Query workflows by user or ID
02Filter by tags and metadata
03Paginate and query date ranges
04Inspect workflow, job, and step details
05View or download generated results

Use cases

01Find a user's recent generation workflows
02Investigate job status and scan results
03Filter workflows for a specific project
04Download images or videos from a workflow

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/civitai/civitai --skill civitai-orchestration

After installing, type/civitai-orchestrationin Claude Code to confirm it loaded.

Bundled files.env.examplecivitai-client.js

Details

From the project README

Civitai Orchestration

Interact with the Civitai Orchestration API to query workflows, view job details, and retrieve generation results.

Quick Start

# Query workflows for a specific user
node .claude/skills/civitai-orchestration/civitai-client.js user 12345

# Get a specific workflow by ID
node .claude/skills/civitai-orchestration/civitai-client.js workflow <workflowId>

# Get job details with scan results (hive_csam_score, etc.)
node .claude/skills/civitai-orchestration/civitai-client.js job <jobId>

# Get step details from a workflow
node .claude/skills/civitai-orchestration/civitai-client.js step <workflowId> <stepName>

# Download result images/videos from a workflow
node .claude/skills/civitai-orchestration/civitai-client.js results <workflowId>

Searching & Filtering

By User ID

# Get workflows for user 12345
node civitai-client.js user 12345

# With options
node civitai-client.js user 12345 --take=5 --excludeFailed

By Workflow ID

# Direct lookup by workflow ID
node civitai-client.js workflow 0-019be44b-181e-7a7e-ab1b-b58dc7610dca

By Date Range

Note: Date filtering may have limited functionality depending on API access level.

# Workflows from the last 7 days
node civitai-client.js workflows --from=2024-01-15 --to=2024-01-22

# Workflows from a specific day
node civitai-client.js workflows --from=2024-01-20 --to=2024-01-20

# Dates are assumed to be UTC. Add Z suffix for explicit UTC:
node civitai-client.js workflows --from=2024-01-20T06:00:00Z --to=2024-01-20T12:00:00Z

Alternative: Use --oldest to get workflows from oldest first, then paginate:

# Get oldest workflows first
node civitai-client.js workflows --oldest --take=50

By Tags

Tags are set when workflows are created. Common tag patterns:

# Filter by a specific tag
node civitai-client.js workflows --tag=user:12345

# Note: Multiple tags can be specified (AND logic)
node civitai-client.js workflows --tag=project:myproject --tag=type:image

By Metadata Search

The --query option searches workflow metadata:

# Search metadata for a string
node civitai-client.js workflows --query="portrait"

By Status

The API supports excluding failed workflows but not filtering by specific status:

# Exclude failed/canceled workflows (get only succeeded/processing)
node civitai-client.js workflows --excludeFailed

# Include all statuses (default behavior)
node civitai-client.js workflows

Note: To find specific statuses, retrieve workflows and filter client-side, or use metadata/tags when creating workflows for better filtering.

Pagination

# Get 50 results
node civitai-client.js workflows --take=50

# Get next page using cursor from previous response
node civitai-client.js workflows --take=20 --cursor=<nextCursor>

Combined Filters

# Successful workflows for a specific tag, excluding failures
node civitai-client.js workflows \
  --tag=user:12345 \
  --excludeFailed \
  --take=50

# Get workflows with metadata search
node civitai-client.js workflows \
  --query="portrait" \
  --excludeFailed \
  --take=20

Commands Reference

test

Test API connection and verify credentials.

node civitai-client.js test

user

Query workflows for a specific user by their Civitai user ID.

node civitai-client.js user <userId> [options]

Options:

Option	Description
`--take=<n>`	Number of results (max 10 per API limit)
`--tag=<tag>`	Filter by tag
`--query=<text>`	Search workflow metadata
`--excludeFailed`	Exclude failed/canceled workflows
`--oldest`	Sort from oldest to newest

workflows

List and search workflows with optional filters.

node civitai-client.js workflows [options]

Options:

Option	Description
`--tag=<tag>`	Filter by tag (can specify multiple)
`--query=<text>`	Search workflow metadata
`--excludeFailed`	Exclude failed/canceled workflows
`--oldest`	Sort from oldest to newest
`--take=<n>`	Number of results (default: 20)
`--cursor=<cursor>`	Pagination cursor
`--from=<date>`	Start date (may have limited support)
`--to=<date>`	End date (may have limited support)

workflow

Get details of a specific workflow.

node civitai-client.js workflow <workflowId> [--wait]

Options:

Option	Description
`--wait`	Wait/poll for completion (with timeout)

job

Get details of a specific job including scan results from event context.

This is useful for investigating content moderation results - the lastEvent.context contains scan scores like hive_csam_score and hive_vlm_summary.

node civitai-client.js job <jobId> [--raw]

Options:

Option	Description
`--raw`	Output raw JSON instead of formatted summary

Example output:

Job Summary:
  ID: 58de87d7-d594-4d71-ae43-dd8fc1bcbd23
  Type: TextToImageV2
  Workflow ID: 8484131-20260121222126332

Prompt Classification: sexual, young, scan

Results (2 blob(s)):
  - JNFDW54JNTATNW42HACYCWSQP0.jpeg (available: true)

Last Event:
  Type: Succeeded
  Provider: ValdiAI

Event Context (scan results, metrics):
  ** hive_csam_score: 0.00 %, 0.00 %
  ** hive_vlm_summary: X, No_Child

step

Get details of a specific step within a workflow.

node civitai-client.js step <workflowId> <stepName>

results

Download or view results (images/videos) from a workflow.

node civitai-client.js results <workflowId> [--download] [--dir=<path>]

Options:

Option	Description
`--download`	Download result files
`--dir=<path>`	Download directory (default: ./civitai-downloads)

blob

Get a blob (image/video) by ID with optional NSFW handling.

node civitai-client.js blob <blobId> [--download] [--nsfw]

Environment Variables

Stored in .claude/skills/civitai-orchestration/.env:

CIVITAI_API_TOKEN=your_bearer_token
CIVITAI_API_URL=https://orchestration.civitai.com

API Reference

Workflow Query Parameters

The workflows endpoint supports these query parameters:

tags - Array of tags to filter by
query - Search workflow metadata
fromDate / toDate - Date range (ISO 8601) - may have limited support
cursor - Pagination cursor
take - Number of results (default: 100)
excludeFailed - Exclude failed/expired/canceled workflows (boolean)
ascending - Sort oldest to newest (boolean)

Workflow Statuses

Status	Description
`preparing`	Workflow being prepared
`scheduled`	Scheduled for execution
`processing`	Currently running
`succeeded`	Completed successfully
`failed`	Failed with error
`canceled`	Was canceled
`expired`	Timed out
`deleted`	Deleted

Step Types (Recipes)

Image/Video generation steps you might encounter:

textToImage - Text to image generation
imageGen - General image generation
videoGen - Video generation
videoEnhancement - Video upscaling/enhancement
videoFrameExtraction - Extract frames from video
videoUpscaler - Upscale video
videoInterpolation - Frame interpolation
convertImage - Convert image formats
comfy - ComfyUI workflow execution
preprocessImage - ControlNet preprocessor over an image (output is a blob, an image)
preprocessVideo - ControlNet preprocessor over a video (output is a blob, a VideoBlob)
aceStepAudio - Audio generation; blob is AudioBlob, or VideoBlob in cover-image mode
miniMaxMusic3 - Music generation

Examples

Query a user's recent image generations

# Get user 12345's recent workflows
node civitai-client.js user 12345

# Exclude failed jobs
node civitai-client.js user 12345 --excludeFailed

Get workflow and view results

# Get workflow details
node civitai-client.js workflow abc123-def456

# View/download results
node civitai-client.js results abc123-def456 --download --dir=./my-images

Paginate through workflows

# First page
node civitai-client.js workflows --take=10

# Next page (use cursor from previous response)
node civitai-client.js workflows --take=10 --cursor=<nextCursor>

Error Handling

Error Code	Meaning
401	Invalid or expired token - check CIVITAI_API_TOKEN
404	Workflow/Job not found
429	Rate limited - wait before retrying
422	Invalid parameters

Output

The user command displays workflow summaries including:

Workflow ID, status, timestamps
Step types (textToImage, videoGen, comfy, etc.)
Prompts for text-to-image generations

For raw JSON output, use the workflow command:

node civitai-client.js workflow <workflowId>

Comments

Markdown supported

Details

Author: civitai
Repository: civitai/civitai
Category: Data & databases
Installs: 60
GitHub stars: 7,305

Report

More skills

All skills

hyperframes-core

github.com/heygen-com

930.6k

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

lark-base

open.feishu.cn

823.2k

Operate on Feishu Base: create tables, fields, records, and views; handle statistics, formulas/lookups, forms, dashboards, app mode (BaseApp/AppMode pages and components), Workspace directories, workflows, role permissions, and the template center (Base template categories, lists, and search). Use when encountering Base/multidimensional tables/bitable, BaseApp/AppMode, or /base/ or /app/ links. Do not use lark-apps for BaseApp; route file import/export to lark-drive and authentication/authorization to lark-shared.

lark-sheets

open.feishu.cn

821.8k

Feishu Spreadsheets: create and operate spreadsheets. Supports worksheets and row/column structures (add/delete/merge/size/hide/freeze/group), cell read/write (values/formulas/styles/comments/cell images), range copy/move/sort/fill, find and replace, bulk updates, and creating and maintaining objects such as charts, pivot tables, conditional formatting, filters and filter views, dropdown lists, sparklines, and floating images. Also supports formula validation, restoring historical versions, and importing/exporting local Excel/CSV files and Feishu spreadsheets. Use when users need to create or edit spreadsheets, summarize and visualize data, format spreadsheets, calculate formulas (including migrating Excel formulas), or build financial models (DCF, three statements, budgets, Sensitivity, etc.). For multidimensional tables (Base/bitable), use lark-base. If users want to search for spreadsheet files in cloud storage (Drive/cloud storage) by name or keyword, use lark-drive's drive +search to locate resources first. When users provide a doubao.com /sheets/ URL/token, use this skill directly; do not fall back to WebFetch because the domain is not Feishu. Routing is based on the URL path pattern and token, not the domain.

remotion-best-practices

github.com/remotion-dev

701.4k

Best practices and domain knowledge for building videos programmatically with Remotion (videos in React/TypeScript, rendered to MP4). Use whenever writing or editing Remotion code — scaffolding a video project, animating with interpolate/spring over useCurrentFrame(), sequencing scenes and transitions, captions/subtitles, audio, GIFs/Lottie/3D, charts, visual effects, dynamic duration via calculateMetadata, or rendering. Consult before reaching for a Remotion API, since its components and props evolve (e.g. @remotion/media).