← Back to Skills Marketplace
Neon
by
aiwithabidi
· GitHub ↗
· v1.0.0
342
Downloads
0
Stars
3
Active Installs
1
Versions
Install in OpenClaw
/install neon
Description
Neon serverless Postgres — manage projects, branches, databases, roles, endpoints, and compute via the Neon API. Create database branches for development, ma...
Usage Guidance
This skill largely does what it says — it calls Neon API endpoints and requires NEON_API_KEY. Before installing, consider:
- Provide NEON_API_KEY explicitly in the agent environment rather than relying on a workspace .env file. The script will attempt to read WORKSPACE/.env or ~/.openclaw/workspace/.env to find the key if the env var is absent. If that file contains other secrets, decide whether you want the skill to be able to read it.
- SKILL.md does not disclose that it reads a .env file or the WORKSPACE env var; ask the author to document this behavior or remove the fallback if you prefer stricter privacy.
- Verify the author/source (homepage and GitHub links in SKILL.md) and confirm the API_BASE (https://console.neon.tech) matches your expectations for Neon. If you plan to allow autonomous agent use, consider running the skill in an isolated environment or limiting the NEON_API_KEY scope (least privilege) in Neon.
If you want me to, I can: (a) point out the exact lines that read the .env file, (b) suggest a minimal code change to remove the fallback file read, or (c) draft questions to ask the skill author for clarification.
Capability Analysis
Type: OpenClaw Skill
Name: neon
Version: 1.0.0
The skill provides a CLI for managing Neon serverless Postgres via its official API (console.neon.tech). While the implementation in `scripts/neon.py` appears to contain logic errors—specifically, it fails to process the JSON payloads passed as command-line arguments—it does not exhibit any signs of malicious intent, data exfiltration, or unauthorized access beyond its stated purpose.
Capability Assessment
Purpose & Capability
Name, description, and implemented operations align: the script makes HTTP calls to Neon API endpoints and exposes project/branch/database/role/endpoint/consumption operations. Requiring NEON_API_KEY is appropriate for this purpose.
Instruction Scope
SKILL.md claims 'never stores data locally' and declares only NEON_API_KEY, but the script's get_token() will attempt to read a .env file at WORKSPACE/.env or ~/.openclaw/workspace/.env to retrieve NEON_API_KEY. The SKILL.md does not document this file read or the use of the WORKSPACE env var. Reading user files (even only to find a token) is scope creep relative to the declared behavior and should be disclosed.
Install Mechanism
No install spec; the skill is instruction/code-only and uses only Python stdlib (no external downloads or package installs). This is low risk from an install mechanism perspective.
Credentials
The only required credential is NEON_API_KEY (declared as primary), which is proportionate. However, the script also reads the WORKSPACE environment variable (to locate a .env file) and will read ~/.openclaw/workspace/.env if present. Those env/config path usages are not declared in metadata and could cause the skill to access files the user did not expect.
Persistence & Privilege
always is false and the skill does not request persistent installation or system-wide config changes. It does not modify other skills or system settings. Autonomous invocation remains allowed (platform default).
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install neon - After installation, invoke the skill by name or use
/neon - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of Neon serverless Postgres management skill.
- Manage Neon projects, branches, databases, roles, endpoints, and compute via Neon API.
- Supports database branching, compute scaling, and point-in-time branch restore.
- Zero dependencies; uses Python 3.10+ standard library only.
- All commands available via a simple CLI script with JSON output (human-readable option supported).
- API key (NEON_API_KEY) required; no data stored locally.
Metadata
Frequently Asked Questions
What is Neon?
Neon serverless Postgres — manage projects, branches, databases, roles, endpoints, and compute via the Neon API. Create database branches for development, ma... It is an AI Agent Skill for Claude Code / OpenClaw, with 342 downloads so far.
How do I install Neon?
Run "/install 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 (open-source). 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 aiwithabidi (@aiwithabidi); the current version is v1.0.0.
More Skills