← Back to Skills Marketplace
melvynx

Neon

by Melvyn · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
265
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install cli-neon
Description
Manage Neon Serverless Postgres via CLI - projects, branches, databases, roles, endpoints, connection strings. Use when user mentions 'neon', 'neonctl', 'ser...
README (SKILL.md)

neon

Setup

npm i -g neonctl

Verify installation:

neonctl --version

Always use --output json flag when calling commands programmatically.

Authentication

neonctl auth

Resources

Projects

Command Description
neonctl projects list List all projects
neonctl projects create --name \x3Cname> Create a new project
neonctl projects delete \x3Cid> Delete a project
neonctl projects get \x3Cid> Get project details

Branches

Command Description
neonctl branches list --project-id \x3Cid> List all branches
neonctl branches create --project-id \x3Cid> --name \x3Cname> Create a branch
neonctl branches delete \x3Cbranch-id> --project-id \x3Cid> Delete a branch
neonctl branches get \x3Cbranch-id> --project-id \x3Cid> Get branch details
neonctl branches reset \x3Cbranch-id> --project-id \x3Cid> --parent Reset branch to parent

Databases

Command Description
neonctl databases list --project-id \x3Cid> --branch-id \x3Cid> List databases
neonctl databases create --project-id \x3Cid> --branch-id \x3Cid> --name \x3Cname> Create a database
neonctl databases delete \x3Cname> --project-id \x3Cid> --branch-id \x3Cid> Delete a database

Roles

Command Description
neonctl roles list --project-id \x3Cid> List all roles
neonctl roles create --project-id \x3Cid> --branch-id \x3Cid> --name \x3Cname> Create a role
neonctl roles delete \x3Cname> --project-id \x3Cid> --branch-id \x3Cid> Delete a role

Endpoints

Command Description
neonctl endpoints list --project-id \x3Cid> List all endpoints

Connection Strings

Command Description
neonctl connection-string --project-id \x3Cid> Get default connection string
neonctl connection-string --project-id \x3Cid> --branch-id \x3Cid> Get connection string for a branch
neonctl connection-string --project-id \x3Cid> --branch-id \x3Cid> --database-name \x3Cdb> --role-name \x3Crole> Get connection string with specific db and role

Context

Command Description
neonctl set-context --project-id \x3Cid> Set project context to avoid passing --project-id

Global Flags

Flag Description
--output json Output result as JSON
--project-id \x3Cid> Specify project ID
--api-key \x3Ckey> Use API key for authentication
--no-color Disable colored output
Usage Guidance
This skill is essentially documentation for using the neonctl CLI. Before installing or using it: 1) Confirm you trust the neonctl npm package (look at the npm page, maintainer, and version). 2) Be aware that global npm installs can run code during installation — consider installing in a controlled environment or using a container. 3) Only provide API keys when required and store them securely; the skill itself does not request secrets but the CLI will need authentication to act on your Neon account. 4) If you want the agent to run neonctl commands automatically, understand the agent will be able to invoke the CLI and perform operations on your Neon projects.
Capability Analysis
Type: OpenClaw Skill Name: cli-neon Version: 1.0.0 The skill bundle provides instructions for an AI agent to interact with the official Neon Serverless Postgres CLI (neonctl). It contains standard commands for managing projects, branches, and databases, and uses the legitimate 'npm i -g neonctl' installation command in SKILL.md without any signs of malicious intent or data exfiltration.
Capability Assessment
Purpose & Capability
Name, description, and provided commands all align with Neon/neonctl functionality (projects, branches, databases, roles, endpoints, connection strings). There are no unrelated binaries, env vars, or config paths requested.
Instruction Scope
SKILL.md only documents installing neonctl, authenticating with neonctl, and running neonctl commands (with --output json recommended). It does not instruct reading unrelated files, scanning system state, or exfiltrating data.
Install Mechanism
There is no formal install spec in the registry (instruction-only), but SKILL.md recommends `npm i -g neonctl`. Global npm installs are common for CLIs but run package install scripts — verify the neonctl package source and review npm package metadata before installing.
Credentials
The skill declares no required environment variables or credentials. The documented CLI supports an --api-key flag, which is expected and proportional for a cloud DB management tool.
Persistence & Privilege
Skill is not always-enabled; it is user-invocable and allows normal autonomous invocation. It does not request system-wide persistence or modify other skills' configs.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install cli-neon
  3. After installation, invoke the skill by name or use /cli-neon
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of the neon CLI management skill. - Provides commands for managing Neon Serverless Postgres projects, branches, databases, roles, endpoints, and connection strings via CLI. - Offers authentication, context setting, and support for JSON output for programmatic use. - Details individual commands and global flags for comprehensive Neon database management from the command line.
Metadata
Slug cli-neon
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Neon?

Manage Neon Serverless Postgres via CLI - projects, branches, databases, roles, endpoints, connection strings. Use when user mentions 'neon', 'neonctl', 'ser... It is an AI Agent Skill for Claude Code / OpenClaw, with 265 downloads so far.

How do I install Neon?

Run "/install cli-neon" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Neon free?

Yes, Neon is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Neon support?

Neon is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Neon?

It is built and maintained by Melvyn (@melvynx); the current version is v1.0.0.

💬 Comments