Skill

export-dns-blocklist

Aggregate the user's accumulated tracking-domains.json + ad-trackers.json into a portable DNS blocklist (Pi-hole / AdGuard / hosts / dnsmasq formats). Writes to corpus/exports/. Use when the user wants to push their pixel inventory to a network-level blocker.

npx claudepluginhub danielrosehill/claude-code-plugins --plugin spamhole

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Materialise the corpus into a DNS-level blocklist suitable for Pi-hole, AdGuard Home, `/etc/hosts`, dnsmasq, or NextDNS.

SKILL.md

Similar Skills

cache-components

139.3k

Guides Next.js Cache Components and Partial Prerendering (PPR): 'use cache' directives, cacheLife(), cacheTag(), revalidateTag() for caching, invalidation, static/dynamic optimization. Auto-activates on cacheComponents: true.

cache-components

mcp-builder

124.2k

Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).

9 files

anthropics-skills-13

Stats

Stars0

Forks0

Last CommitApr 30, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

export-dns-blocklist

Materialise the corpus into a DNS-level blocklist suitable for Pi-hole, AdGuard Home, /etc/hosts, dnsmasq, or NextDNS.

Resolve corpus path

Standard config resolver ($CLAUDE_USER_DATA/spamhole/config.json → corpus_path).

Inputs

Format — one of hosts, pihole, adguard, dnsmasq, unbound, plain. Default hosts.

Source — tracking (just tracking-domains.json), ads (just ad-trackers.json), both (default).

Min frequency — only include domains seen ≥ N times across the corpus. Default 1. Higher values reduce false positives.

Steps

Read the relevant inventory file(s). Aggregate by domain. Drop entries that don't meet min_frequency.

Normalise: lowercase, strip ports, drop subdomain noise where the user wants the eTLD+1 form (ask once on first run, persist preference).

Generate the export. Examples:

hosts:

0.0.0.0 mailtrack.io
0.0.0.0 qmailroute.net

pihole (plain domain list, one per line):
```
mailtrack.io
qmailroute.net
```
adguard (||domain^ form):
```
||mailtrack.io^
||qmailroute.net^
```
dnsmasq:
```
address=/mailtrack.io/0.0.0.0
```

unbound:

local-zone: "mailtrack.io." always_nxdomain

Write to <corpus>/exports/spamhole-<format>-<YYYYMMDD>.txt (or .conf for unbound/dnsmasq).

Print a one-line summary of the export path and entry count, plus a hint on how to load it (e.g. for Pi-hole: "Group Management → Adlists, paste the file URL or contents").

Caveats

Some pixel-tracking domains co-host non-tracker content (e.g. list-manage.com also serves Mailchimp's hosted preference centres). Surface a warning when an exported domain is on a known dual-use list — let the user decide.