CtrlK
BlogDocsLog inGet started
Tessl Logo

homelab-pihole-dns

Pi-hole installation, blocklist management, DNS-over-HTTPS setup, DHCP integration, local DNS records, and troubleshooting broken DNS resolution on a home network. Use when the task explicitly involves Pi-hole — installing it, managing blocklists, configuring DoH or DHCP, adding local DNS records, or diagnosing DNS resolution with Pi-hole in the path.

68

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Medium

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

75%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-organized, highly actionable single-file skill: concrete compose files, CLI commands, blocklists, and anti-patterns cover the common homelab cases. The main weaknesses are concept explanations Claude doesn't need, placeholder/version-verification steps that are described rather than executable, and a missing validate-before-network-cutover checkpoint.

Suggestions

Add an explicit validation checkpoint between install and network cutover: verify with "dig @192.168.3.2 pi-hole.net" that Pi-hole resolves correctly before changing router DHCP settings — the current flow points the whole network at Pi-hole without confirming it works.

Trim or cut the "How Pi-hole Works" primer and the "DNS-over-HTTPS encrypts your DNS queries" sentence; Claude already knows what DoH is, so keep only the Pi-hole-specific setup facts.

Replace the vague "Verify the checksum/signature from Cloudflare's release notes" with the actual command (e.g. the sha256sum invocation against the published .b256 file), and the same for the pinned Pi-hole release tag.

DimensionReasoningScore

Conciseness

The body is command-dense and mostly lean, but includes concept primers Claude already knows: "DNS-over-HTTPS encrypts your DNS queries so your ISP cannot see what sites you resolve" and the "How Pi-hole Works" walkthrough. These are minor over-explanations that could be trimmed, matching the 4 anchor rather than the 5 anchor's every-token-earns-its-place.

4 / 5

Actionability

Concrete, mostly copy-paste-ready guidance: a full docker-compose.yml, dhcpcd.conf edits, specific blocklist URLs, and a real troubleshooting CLI section. Falls short of the 5 anchor because of the "<pinned-release-tag>"/"<pinned-version>" placeholders and "Verify the checksum/signature from Cloudflare's release notes" giving no verification command; well above the 3 anchor since the code is genuinely executable, not pseudocode.

4 / 5

Workflow Clarity

Sequences are clear and ordered (static IP → install; disable router DHCP → enable Pi-hole DHCP; DoH proxy → repoint upstream), and verification commands exist ("pihole status", "dig @192.168.3.2 google.com"). A minor validation gap keeps it at 4: no explicit checkpoint confirming Pi-hole resolves correctly before pointing the whole network at it — the network-wide cutover step lacks a validate-before-proceed gate.

4 / 5

Progressive Disclosure

No bundle files exist, so all content is a single ~270-line file — but it is well-sectioned with clear headers (Installation, Blocklist Management, DoH, Local DNS, Troubleshooting, Anti-Patterns) and easy navigation. Matches the 4 anchor: good structure with minor organization gaps; the DoH setup and blocklist catalog are long enough to be one-level-deep reference files. Not 5 because there is no overview-plus-references split, and not 3 because nothing is buried or nested.

4 / 5

Total

16

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete capability list, explicit and enumerated 'Use when' triggers, and a distinct product-gated niche. The only gap is missing the common "ad blocking" phrasing users may use instead of naming Pi-hole.

DimensionReasoningScore

Specificity

"Pi-hole installation, blocklist management, DNS-over-HTTPS setup, DHCP integration, local DNS records, and troubleshooting broken DNS resolution" lists six concrete, distinct capabilities with comprehensive coverage of the skill's scope. No notable coverage gaps, so it sits at the top anchor rather than the 4 anchor's "minor gaps".

5 / 5

Completeness

Explicitly answers both: "what" (six named capabilities) and "when" ("Use when the task explicitly involves Pi-hole — installing it, managing blocklists, configuring DoH or DHCP, adding local DNS records, or diagnosing DNS resolution with Pi-hole in the path"). The trigger clause is explicit and enumerated, matching the 5 anchor exactly rather than the 4 anchor's "when could be more explicit".

5 / 5

Trigger Term Quality

Good natural-term coverage: "Pi-hole", "blocklists", "DNS-over-HTTPS" and "DoH", "DHCP", "DNS resolution", "home network", "local DNS records". A few natural terms are missing — most notably the "ad blocking" / "block ads" phrasing many users would use for Pi-hole — which keeps it below the 5 anchor's synonym-and-extension completeness.

4 / 5

Distinctiveness Conflict Risk

"Use when the task explicitly involves Pi-hole" gates triggering on a unique product name with a clear niche (home-network DNS). Minimal conflict risk with generic DNS, networking, or Docker skills, matching the 5 anchor rather than the 4 anchor's "minor overlap risk".

5 / 5

Total

19

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
affaan-m/ECC
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.