← Back to Skills Marketplace
wmantly

Porkbun

by William Mantly · GitHub ↗ · v0.1.2
cross-platform ✓ Security Clean
1129
Downloads
0
Stars
1
Active Installs
3
Versions
Install in OpenClaw
/install porkbun-skill
Description
Manage Porkbun DNS records and domains via API v3. Use when Codex needs to create, read, update, or delete DNS records on Porkbun; list domains; configure API access; work with common record types (A, AAAA, CNAME, MX, TXT, etc.). The skill includes a CLI tool `scripts/porkbun-dns.js` for executing DNS operations reliably.
Usage Guidance
This skill appears to be what it claims (a Porkbun DNS CLI). Before installing or providing credentials: 1) Verify the skill source (homepage in package.json points to an external git host; confirm you trust the owner). 2) Prefer exporting ephemeral API keys or use a key pair with minimal privileges; rotate keys after use. 3) If using the config file (~/.config/porkbun/config.json), restrict file permissions (e.g., chmod 600). 4) Review the script if possible — it posts credentials only to api.porkbun.com; look for unexpected endpoints. 5) Note the registry metadata inconsistency (it listed no required env vars while package.json and SKILL.md do); correct metadata or confirm requirements before automating deployment. Finally, the script has a minor bug (uses console.err which is undefined) but that is not a security issue — it's a quality note.
Capability Analysis
Type: OpenClaw Skill Name: porkbun-skill Version: 0.1.2 The OpenClaw skill 'porkbun-skill' is designed for managing Porkbun DNS records via their API. The `scripts/porkbun-dns.js` script correctly implements API interactions, loads credentials from environment variables or a standard config file (`~/.config/porkbun/config.json`), and performs only the stated DNS operations. There is no evidence of intentional harmful behavior such as data exfiltration to unauthorized endpoints, persistence mechanisms, or obfuscation. The `SKILL.md` instructions are clear and directly relate to DNS management, and the `curl -s ifconfig.me` example is a common, non-malicious pattern for dynamic DNS updates.
Capability Assessment
Purpose & Capability
The name/description, SKILL.md, package.json, and scripts/porkbun-dns.js all describe the same purpose (manage Porkbun DNS via API v3). The CLI implements list/get/create/edit/delete operations that match the described functionality.
Instruction Scope
Runtime instructions ask the agent/user to provide Porkbun API keys via environment variables or a config file (~/.config/porkbun/config.json). The SKILL.md and the script reference only Porkbun's API endpoints (api.porkbun.com) and local config paths; they do not attempt to read unrelated system files. Note: the top registry summary showed 'Required env vars: none', which contradicts package.json and SKILL.md that require PORKBUN_API_KEY and PORKBUN_SECRET_API_KEY.
Install Mechanism
This is an instruction-only skill with no install spec and a single CLI script included. Nothing is downloaded at install time and no external installers or URLs are used, minimizing install-time risk.
Credentials
The script legitimately needs Porkbun API credentials. package.json and SKILL.md declare PORKBUN_API_KEY and PORKBUN_SECRET_API_KEY and a config path; these are proportionate. Caveat: the registry metadata at the top of the report erroneously listed 'Required env vars: none' — this mismatch should be corrected before trusting automated policies that rely on registry metadata. The tool will read HOME to locate the config file; storing the secret in plaintext at ~/.config/porkbun/config.json is expected but users should ensure file permissions are restricted.
Persistence & Privilege
The skill does not request always:true, does not modify other skills or system-wide settings, and does not persist beyond its included files. Autonomous invocation is allowed (platform default) but not combined with elevated privileges or unrelated credential access.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install porkbun-skill
  3. After installation, invoke the skill by name or use /porkbun-skill
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.2
- Initial release of porkbun-skill. - Added CLI tool `scripts/porkbun-dns.js` to manage Porkbun DNS records and domains via API v3. - Added `package.json` for dependency management and CLI script setup. - Included a changelog file (CHANGELOG.md) for tracking updates.
v0.1.1
- Removed the CLI tool script `scripts/porkbun-dns.js` from the skill. - Documentation references to using `scripts/porkbun-dns.js` remain in SKILL.md, but the script itself is no longer included.
v0.1.0
Initial release of Porkbun DNS Management skill. - Provides CLI tool to manage Porkbun DNS records and domains via API v3. - Supports creating, reading, updating, and deleting common record types (A, AAAA, CNAME, MX, TXT, etc.). - Includes guided setup for API credentials with both config file and environment variable options. - Offers reliable, scriptable DNS operations for common use cases such as website setup, email configuration, dynamic DNS, and wildcard DNS. - Reference documentation and troubleshooting tips included for easy onboarding.
Metadata
Slug porkbun-skill
Version 0.1.2
License
All-time Installs 1
Active Installs 1
Total Versions 3
Frequently Asked Questions

What is Porkbun?

Manage Porkbun DNS records and domains via API v3. Use when Codex needs to create, read, update, or delete DNS records on Porkbun; list domains; configure API access; work with common record types (A, AAAA, CNAME, MX, TXT, etc.). The skill includes a CLI tool `scripts/porkbun-dns.js` for executing DNS operations reliably. It is an AI Agent Skill for Claude Code / OpenClaw, with 1129 downloads so far.

How do I install Porkbun?

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

Is Porkbun free?

Yes, Porkbun is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Porkbun support?

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

Who created Porkbun?

It is built and maintained by William Mantly (@wmantly); the current version is v0.1.2.

💬 Comments