About dataproc-skills
dataproc-skills is a set of Node.js scripts for retrieving and listing Google Dataproc clusters and jobs. It supports filtering and pagination, with environment variables loaded automatically from .env files.
Key features
- 01Get a cluster by name
- 02Get a job by ID
- 03List clusters with filters
- 04List jobs with state matching
- 05Paginate cluster and job results
- 06Load environment variables from .env files
Use cases
- 01Checking the details of a Dataproc cluster
- 02Looking up a Dataproc job by ID
- 03Listing clusters by status or labels
- 04Finding active or completed jobs
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ cline/ skills --skill dataproc-skillsAfter installing, type/dataproc-skillsin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
scripts/get_cluster.jsget_job.jslist_clusters.jslist_jobs.jsDetails
From the project READMEUsage
All scripts can be executed using Node.js. Replace <param_name> and <param_value> with actual values.
Bash:
node <skill_dir>/scripts/<script_name>.js '{"<param_name>": "<param_value>"}'
PowerShell:
node <skill_dir>/scripts/<script_name>.js '{\"<param_name>\": \"<param_value>\"}'
Note: The scripts automatically load the environment variables from various .env files. Do not ask the user to set vars unless skill executions fails due to env var absence.
Scripts
get_cluster
Gets a Dataproc cluster
Parameters
| Name | Type | Description | Required | Default |
|---|---|---|---|---|
| clusterName | string | The short name of the cluster, e.g. for "projects/my-project/regions/us-central1/clusters/my-cluster", pass "my-cluster" (the project and region are inherited from the source) | No |
get_job
Gets a Dataproc job
Parameters
| Name | Type | Description | Required | Default |
|---|---|---|---|---|
| jobId | string | The job ID, e.g. for "projects/my-project/regions/us-central1/jobs/my-job", pass "my-job" (the project and region are inherited from the source) | No |
list_clusters
Lists and filters Dataproc clusters
Parameters
| Name | Type | Description | Required | Default |
|---|---|---|---|---|
| filter | string | A filter constraining the clusters to list. Filters are case-sensitive and have the following syntax: field = value [AND [field = value]] ... where field is one of status.state, clusterName, or labels.[KEY], and [KEY] is a label key. value can be * to match all values. status.state can be one of the following: ACTIVE, INACTIVE, CREATING, RUNNING, ERROR, DELETING, UPDATING, STOPPING, or STOPPED. ACTIVE contains the CREATING, UPDATING, and RUNNING states. INACTIVE contains the DELETING, ERROR, STOPPING, and STOPPED states. clusterName is the name of the cluster provided at creation time. Only the logical AND operator is supported; space-separated items are treated as having an implicit AND operator. | No | |
| pageSize | integer | The maximum number of clusters to return in a single page (default 20) | No | 20 |
| pageToken | string | A page token, received from a previous ListClusters call | No |
list_jobs
Lists and filters Dataproc jobs
Parameters
| Name | Type | Description | Required | Default |
|---|---|---|---|---|
| filter | string | A filter constraining the jobs to list. Filters are case-sensitive and have the following syntax: field = value [AND [field = value]] ... where field is clusterName, status.state, or labels.[KEY], and [KEY] is a label key. value can be * to match all values. status.state can be one of the following: PENDING, RUNNING, CANCEL_PENDING, JOB_STATE_CANCELLED, DONE, ERROR, or ATTEMPT_FAILURE. Only the logical AND operator is supported; space-separated items are treated as having an implicit AND operator. Filtering by clusterName is recommended to improve query performance. | No | |
| jobStateMatcher | string | Specifies if the job state matcher should match ALL jobs, only ACTIVE jobs, or only NON_ACTIVE jobs. Defaults to ALL. Supported values: ALL, ACTIVE, NON_ACTIVE. | No | |
| pageSize | integer | The maximum number of jobs to return in a single page (default 20) | No | 20 |
| pageToken | string | A page token, received from a previous ListJobs call | No |