nixopus/domain-attachment
skills/domain-attachment/SKILL.md
Domain setup for applications. Preferred path is passing domains at creation time via createProject. Falls back to add_application_domain for post-creation attachment or custom domains.
$ install --global
skillsauthnpx skillsauth add nixopus/agent domain-attachmentInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 22, 2026, 11:56 PM355.9s1 file scanned
SKILL.md
- name:
- domain-attachment
- description:
- Domain setup for applications. Preferred path is passing domains at creation time via createProject. Falls back to add_application_domain for post-creation attachment or custom domains.
- version:
- 1.1
Domain Attachment
Preferred: Pass Domain at Creation Time
The fastest path — zero extra tool calls after project creation:
- Call
generate_random_subdomainto get a subdomain. - Pass
domains: ["<subdomain>"]in thecreateProjectcall. - Done — the domain is attached at creation, wildcard DNS and TLS are automatic.
Use this path for all standard deploys. Only fall back to the post-creation flow below when adding domains to an existing app or when the user wants a custom domain.
Post-Creation: Auto-Generated Subdomain
If the app already exists and has no domain:
- Call
generate_random_subdomain. - Call
add_application_domainwith id (app UUID) and the subdomain. - Done — wildcard DNS and TLS are handled automatically.
Step 4: Custom Domain Setup
If the user wants a custom domain (e.g. app.example.com):
- Call
create_domainwith the domain name. - The response includes DNS setup instructions. Relay them clearly to the user:
- CNAME record: point the domain to their assigned
subdomain.nixopus.ai - TXT record:
_nixopus-verify.{domain}with the verification value from the response
- CNAME record: point the domain to their assigned
- Tell the user to add both records at their DNS provider (Cloudflare, Namecheap, Route53, GoDaddy, etc.).
- After the user confirms DNS is configured, call
update_domainwith the domain ID to verify. - If verification succeeds, call
add_application_domainto attach the domain. - If verification fails:
- DNS propagation can take minutes to 48 hours depending on the provider.
- Suggest the user wait and retry, or check their DNS records are correct.
- For deeper troubleshooting:
read_skill("domain-tls-routing").
Common DNS Provider Notes
| Provider | Propagation | Notes | |----------|-------------|-------| | Cloudflare | Near-instant | Disable orange cloud (proxy) for the CNAME initially so verification passes | | Namecheap | 5-30 minutes | Use "CNAME Record" type, host = subdomain part only | | Route53 | 60 seconds | Standard CNAME + TXT | | GoDaddy | Up to 48 hours | Slowest propagation |
Important
- Never skip domain attachment — a deployed app without a domain is not reachable.
- For Compose apps,
add_application_domainaccepts an optionalservice_nameandportto route to a specific service.
Related Skills
nixopus/api-catalog
tools
VerifiedTrustedCommunity
Compressed catalog of all Nixopus API operations for the nixopus_api() tool
1SKILL.mdUpdated Apr 26, 2026
nixopus/static-deploy
development
VerifiedTrustedCommunity
Deploy static file sites — Caddy/nginx serving, Staticfile config, and Dockerfile patterns. Use when deploying a static HTML site with no server-side runtime, or when index.html or a Staticfile is detected at the project root.
1SKILL.mdUpdated Apr 22, 2026
nixopus/shell-deploy
devops
VerifiedTrustedCommunity
Deploy shell script applications — interpreter detection, setup scripts, and Dockerfile patterns. Use when deploying a shell script project, or when start.sh is detected.
1SKILL.mdUpdated Apr 22, 2026
nixopus/self-heal
development
VerifiedTrustedCommunity
Self-healing loop for failed deployments — diagnose, fix, redeploy up to 3 attempts, then escalate or rollback. Load when a deployment fails or build errors occur.
1SKILL.mdUpdated Apr 22, 2026