Skip to content

ericrisco/rsc-harness / skills/domains-dns

domains-dns

Verified

Use when pointing a domain at a host or fixing broken HTTPS — delegating nameservers, writing A/AAAA/CNAME/ALIAS/MX/TXT/CAA rows, apex vs www, standing up auto-renewing TLS, and cutting nameservers over without downtime. NOT inbox placement or warmup (that is `email-deliverability`), NOT what runs behind the name (that is `deployment`).

FileKindSize
SKILL.mdskill md9.6 KB
evals/README.mdmarkdown1.1 KB
evals/cases.yamlconfig3.2 KB
references/record-cookbook.mdmarkdown4.4 KB
references/tls-and-acme.mdmarkdown4.3 KB
references/verify-and-debug.mdmarkdown3.5 KB
scripts/verify.shexecutablescript6.3 KB

references/verify-and-debug.md

View on GitHub
# Verify & debug playbook

Always query the authoritative answer and the wire. Your laptop's resolver caches the old answer for the record's full TTL and will lie to you.

## dig — resolution

```bash
dig +short app.example.com                 # what your resolver returns right now
dig +short app.example.com @1.1.1.1         # what a public resolver returns (bypasses local cache)
dig +trace example.com                      # walk root → TLD → authoritative; reveals stale/wrong NS
dig NS example.com +short                   # the delegated nameservers
dig @ns1.provider.net example.com A +short  # ask the authoritative NS directly — the source of truth
dig CAA example.com +short                  # CA authorization at the apex
dig TXT _dmarc.example.com +short           # confirm a TXT row took
```

- `dig +short` shows the resolved value; drop `+short` to see the TTL counting down (low number = recently changed or short TTL).
- If `dig @<authoritative>` is correct but `dig +short` is wrong, it's **caching** — wait out the TTL or query a fresh resolver. Don't re-edit the record.

## openssl — the served chain

```bash
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null \
  | openssl x509 -noout -subject -issuer -dates
```

- `-servername` sends SNI; without it a multi-tenant host serves the wrong/default cert and you misdiagnose.
- Check `notAfter` is comfortably ahead. Check `issuer` matches your CAA.
- To see whether the **chain is complete**, look at the full handshake output for the intermediate; an incomplete chain is the curl/mobile-only failure.

## curl — the HTTP verdict

```bash
curl -vI https://example.com 2>&1 | grep -Ei 'HTTP/|location|SSL certificate'
curl -sI https://www.example.com -o /dev/null -w '%{http_code} %{redirect_url}\n'
```

- `SSL certificate verify ok` = chain validates from curl's bundle (catches missing intermediates browsers hide).
- Confirm www and apex resolve to the same canonical host and one 301s to the other.

## Propagation, the right way

Propagation is the **TTL**, not a fixed window (RFC 2181). To make a change land fast:

1. Lower the record's TTL to 300s **before** you change the value.
2. Wait for the old TTL to elapse so resolvers re-query at the new rate.
3. Change the value; new value is picked up within ~5 min.
4. Raise the TTL back afterward.

NS/registrar delegation changes can lag longer because of registry/TLD TTLs — that's the parent zone, outside your control.

## Error → cause → fix

| Symptom | Cause | Fix |
| --- | --- | --- |
| `NXDOMAIN` | Name doesn't exist in the zone, or wrong zone is authoritative | Confirm record exists; `dig NS` that delegation points at the right provider |
| `SERVFAIL` | Broken delegation, or DNSSEC DS mismatch | Match registrar NS to provider; fix/remove stale DS |
| `dig +short` right but browser wrong | Local/OS/browser cache | Flush OS cache or query `@1.1.1.1`; wait the TTL |
| `dig +trace` shows old IP | Authoritative zone not updated, or queried a stale secondary | Edit at the authoritative provider; bump SOA serial |
| `ERR_CERT_AUTHORITY_INVALID` (curl/mobile) | Incomplete chain | Serve `fullchain.pem` |
| `ERR_CERT_COMMON_NAME_INVALID` | Cert SAN doesn't cover the hostname | Reissue covering apex + www |
| ACME CAA error | CAA forbids your CA | Add `CAA 0 issue "<ca>"` |
| HTTPS warns despite valid cert | Mixed content | Serve all subresources over HTTPS |
| Redirect loop on HTTPS | Cloudflare SSL set to Flexible against an HTTPS origin | Set Full (strict) |
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 322kUpdated Claude CodeCodexVerifiedInstall
xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release.Stars: 118kUpdated Claude CodeCodexVerifiedInstall