From 3cd14cedd0c2052c13e5ab3470d49706e47b0bb7 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 29 May 2026 21:58:31 +0000
Subject: [PATCH] docs(namecheap): document JSON schemas for setHosts and
 forwarding files

Co-authored-by: brunoborges <129743+brunoborges@users.noreply.github.com>
---
 skills/namecheap/SKILL.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/skills/namecheap/SKILL.md b/skills/namecheap/SKILL.md
index 54669247..1fae5cea 100644
--- a/skills/namecheap/SKILL.md
+++ b/skills/namecheap/SKILL.md
@@ -79,6 +79,27 @@ python3 namecheap.py domains.ns.getInfo --domain example.com --nameserver ns1.ex
 python3 namecheap.py domains.ns.update --domain example.com --nameserver ns1.example.com --old-ip 1.2.3.4 --ip 5.6.7.8
 ```
 
+### JSON file formats
+
+`domains.dns.setHosts --hosts records.json` expects an array of objects with Namecheap API field names:
+
+```json
+[
+  { "HostName": "@", "RecordType": "A", "Address": "1.2.3.4", "TTL": 1800 },
+  { "HostName": "www", "RecordType": "CNAME", "Address": "@", "TTL": 1800 },
+  { "HostName": "@", "RecordType": "MX", "Address": "mail.example.com.", "TTL": 1800, "MXPref": 10 }
+]
+```
+
+`domains.dns.setEmailForwarding --forwards forwards.json` expects an array of mailbox rules:
+
+```json
+[
+  { "MailBox": "info", "ForwardTo": "team@example.net" },
+  { "MailBox": "sales", "ForwardTo": "owner@example.net" }
+]
+```
+
 ## Behavior
 
 - **Always check credentials first.** Before any API operation, verify `~/.namecheap-api` exists and is readable. If not, run the setup flow.