goldsky-secrets

Manage Goldsky pipeline sink credentials for PostgreSQL, ClickHouse, Kafka, and S3.

1|1|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/goldsky-io/agent-skills --skill goldsky-secrets
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: goldsky-secrets
Source: https://github.com/goldsky-io/agent-skills/tree/main/skills/goldsky-secrets
Command: npx skills add https://github.com/goldsky-io/agent-skills --skill goldsky-secrets

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, and includes scripts (resource) components.

What problem does it solve?

Goldsky Secrets provides a secure, scalable way to create, store, rotate, and reference credentials used by common pipeline sinks (PostgreSQL, ClickHouse, Kafka, S3, and more) within Goldsky pipelines, removing the need to hard-code secrets.

Core Features & Use Cases

  • Create, list, reveal, update, and delete secrets for sinks (PostgreSQL, ClickHouse, Kafka, S3, etc.) used by pipelines.
  • Parse PostgreSQL connection strings automatically to generate the secret payload and create secrets in one step.
  • Follow provider-specific guidance for Neon, Supabase, PlanetScale, and other services to simplify secret creation.

Quick Start

Create a new secret by name using the Goldsky CLI: goldsky secret create --name YOUR_SECRET The CLI will prompt for the secret type and values, or you can pass a pre-built JSON payload with --value that conforms to the secret schema. For PostgreSQL, use type "jdbc", protocol "postgres", and fields host, port, databaseName, user, password. If you have a PostgreSQL connection string, run the included script to produce the JSON and then create the secret: ./scripts/parse-connection-string.sh "postgresql://user:pass@host:5432/db" | xargs -I {} goldsky secret create --name YOUR_SECRET --value '{}'

Frequently Asked Questions about goldsky-secrets

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

FAQPage Schema
How do I manage credentials for Goldsky pipeline sinks without hard-coding secrets?

Use the included script to parse a PostgreSQL connection string and generate the required JSON payload automatically. Run ./scripts/parse-connection-string.sh with your URI, then pipe the output to the goldsky secret create command with the --value flag.

What fields are required in the JSON payload for a PostgreSQL sink secret?

A PostgreSQL sink secret requires a JSON payload with type set to jdbc, protocol set to postgres, and fields including host, port, databaseName, user, and password. The skill enforces this schema to ensure pipeline connections are configured correctly.

Can I use this skill to create secrets for managed database services like Neon or Supabase?

Yes, you can create secrets for managed services like Neon, Supabase, and PlanetScale. The skill provides provider-specific guidance to simplify the secret creation process for these PostgreSQL-compatible database platforms.

Do I need jq installed to manage Goldsky pipeline secrets with this skill?

Yes, jq is a required dependency for this skill. You need the jq command-line JSON processor installed in your environment to support parsing and generating the JSON secret payloads required by the Goldsky CLI.

How do I update or delete existing sink credentials used in my Goldsky pipelines?

You can update or delete existing sink credentials by using the Goldsky CLI commands supported by this skill. It provides full lifecycle management, allowing you to list, reveal, update, and delete secrets for your active data pipelines.