create-job

Create and start a job on a NovaDB branch using job definitions and optional input files.

Updated Feb 27, 2026
One-click install
npx skills add https://github.com/novadb/claude-plugins --skill create-job
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-job
Source: https://github.com/novadb/claude-plugins/tree/main/consulting/skills/create-job
Command: npx skills add https://github.com/novadb/claude-plugins --skill create-job

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creating and starting jobs on a branch in NovaDB requires multiple steps and follow-up calls to retrieve the full job object, which is tedious and error-prone when done manually.

Core Features & Use Cases

  • Two-step orchestration: Calls novadb_cms_create_job to create and start a job, then novadb_cms_get_job to fetch the full job object.
  • Flexible inputs: Accepts branch ID, job definition, scope/object lists, parameters, and optional uploaded input files.
  • Use Case: Start a data transformation job on a branch and immediately return its id, state, progress, and timestamps for monitoring or reporting.

Quick Start

Create and start a job on branch 2100347 with job definition 12345 and return the full job details after creation.

Frequently Asked Questions about create-job

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create and start a job on a NovaDB branch?

To create and start a job on a NovaDB branch, you provide a branch ID, job definition, scope, and parameters. The process calls novadb_cms_create_job to initiate the job and obtain an ID for tracking.

What inputs are required for NovaDB branch job creation?

NovaDB branch job creation requires a branch ID and a job definition. You can also supply scope or object lists, custom parameters, and optional uploaded input files to configure the workflow.

How do I get full job details after creating a branch job in NovaDB?

To get full job details after creating a branch job in NovaDB, a follow-up call to novadb_cms_get_job is required. This retrieves the complete job object including its state, progress, and timestamps.

Can I pass uploaded files when starting a job on a NovaDB branch?

Yes, you can pass uploaded files when starting a job on a NovaDB branch. The job creation process accepts optional uploaded input files alongside the required branch ID and job definition.

Why does NovaDB job creation require two separate API calls?

NovaDB job creation requires two API calls to first create and start the job via novadb_cms_create_job, then fetch the full job object using novadb_cms_get_job. This two-step orchestration ensures accurate retrieval of execution state and timestamps.