Namecheap skill

[brunoborges]

Pull Request Checklist

• I have read and followed the CONTRIBUTING.md guidelines.
• I have read and followed the Guidance for submissions involving paid services.
• My contribution adds a new instruction, prompt, agent, skill, or workflow file in the correct directory.
• The file follows the required naming convention.
• The content is clearly structured and follows the example format.
• I have tested my instructions, prompt, agent, skill, or workflow with GitHub Copilot.
• I have run npm start and verified that README.md is up to date.
• I am targeting the staged branch for this pull request.

---

Description

Namecheap DNS Management Skill

---

Type of Contribution

• New instruction file.
• New prompt file.
• New agent file.
• New plugin.
• New skill file.
• New agentic workflow.
• Update to existing instruction, prompt, agent, plugin, skill, or workflow.
• Other (please specify):

---

Additional Notes

---

By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.

[github-actions]

🔍 Skill Validator Results

✅ All checks passed

Scope	Checked
Skills	1
Agents	0
Total	1
Severity	Count
---	---:
❌ Errors	0
⚠️ Warnings	0
ℹ️ Advisories	0

Summary

Level	Finding
ℹ️	Found 1 skill(s)
ℹ️	[namecheap] 📊 namecheap: 1,512 BPE tokens [chars/4: 1,569] (detailed ✓), 25 sections, 2 code blocks
ℹ️	✅ All checks passed (1 skill(s))

Full validator output

```text Found 1 skill(s) [namecheap] 📊 namecheap: 1,512 BPE tokens [chars/4: 1,569] (detailed ✓), 25 sections, 2 code blocks ✅ All checks passed (1 skill(s)) ```

[Copilot]

Pull request overview

Adds a new "namecheap" skill that wraps the Namecheap XML API for DNS management, including domain listing, host record CRUD, nameserver and email-forwarding operations, plus a setup flow that detects the public IP and stores credentials in ~/.namecheap-api.

Changes:

• New skills/namecheap/SKILL.md describing the workflow, supported operations, and credential storage.
• New skills/namecheap/namecheap.sh Bash CLI that issues API requests and performs fetch-modify-write for safe single-record add/remove.
• New skills/namecheap/references/namecheap-api.md reference and a generated entry in docs/README.skills.md.

Show a summary per file

File	Description
skills/namecheap/SKILL.md	Skill metadata, workflow, behavior rules, and credential-storage guidance.
skills/namecheap/namecheap.sh	Bash wrapper implementing all documented API commands and the setup flow.
skills/namecheap/references/namecheap-api.md	API reference: parameters, XML response shapes, error codes, record/TTL tables.
docs/README.skills.md	Generated skills index entry for the new namecheap skill.

Copilot's findings

• Files reviewed: 4/4 changed files
• Comments generated: 7

[brunoborges]

Addressed all of Copilot's review feedback by rewriting the skill in Python (stdlib-only namecheap.py), replacing the Bash script. This resolves the comments structurally:

• Public IP caching — fetched once per run, not per request.
• API key safety — requests are built in-process with urllib; the key never appears in process argv or shell history (the prior curl positional-arg risk is gone).
• Multi-part TLDs — broadened detection (co.uk, com.au, co.jp, …) with a documented limitation in SKILL.md.
• Setup updates existing creds — now prompts before overwriting.
• No secrets via chat — SKILL.md instructs running setup in your own terminal (getpass) or using NAMECHEAP_API_USER/NAMECHEAP_API_KEY env vars.
• Portability — removed fragile inline local and grep -oP (not on macOS/BSD); Python runs cross-platform with no dependencies.

Additional hardening: domain-case normalization, MX priority 0 preserved, case-insensitive record types, and mixed-case email-forwarding attributes handled. Validated with npm run skill:validate (350 skills), npm run build, and eng/fix-line-endings.sh.

[Copilot]

Copilot's findings

• Files reviewed: 4/4 changed files
• Comments generated: 1