One-click install
npx skills add https://github.com/mickpletcher/AI-Skills --skill pihole-blocklist
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pihole-blocklist
Source: https://github.com/mickpletcher/AI-Skills/tree/main/claude/skills/pihole-blocklist
Command: npx skills add https://github.com/mickpletcher/AI-Skills --skill pihole-blocklist

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you decide whether a new Pi-hole blocklist source is high quality, fits your curation taxonomy, and won’t introduce avoidable false positives.

Core Features & Use Cases

  • Structured Source Evaluation: Produces a consistent, repo-ready assessment including category, risks, format, overlap risk, and recommendation.
  • Category Taxonomy Alignment: Assigns exactly one primary category from the curated list to keep additions consistent and discoverable.
  • Pi-hole Readiness Checks: Verifies compatibility expectations such as raw URL availability and hosts vs plain domain list formatting.
  • Curation-Oriented Output: Generates content suitable for documenting the decision and committing updates to the curated blocklist index.

Quick Start

Use pihole-blocklist to evaluate a candidate blocklist by pasting the raw blocklist URL and asking whether it should be added, skipped, or handled with caution.

Frequently Asked Questions about pihole-blocklist

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I evaluate a new Pi-hole blocklist source for false positives?

Evaluating a Pi-hole blocklist involves checking category fit, quality signals, format compatibility, and operational risk to identify false positives. This structured assessment ensures your curated blocklist index avoids introducing unnecessary blocking errors.

What is blocklist curation taxonomy and when do I need it?

Blocklist curation taxonomy assigns exactly one primary category to each Pi-hole source to maintain consistency. You need this structured evaluation when adding new ad, tracker, or malware sources to keep your blocklist entries organized and discoverable.

How to check if a blocklist URL is compatible with Pi-hole formatting?

Checking Pi-hole format compatibility involves verifying raw URL availability and distinguishing between hosts file formatting and plain domain lists. This readiness check ensures the blocklist source can be parsed correctly without operational failures.

Does this blocklist evaluation method generate repo-ready documentation?

Yes, blocklist evaluation generates repo-ready documentation by producing a structured assessment with category, overlap risk, and recommendation fields. This curation-oriented output is suitable for committing updates directly to your blocklist index.

What are the limitations of automated Pi-hole blocklist assessment?

Automated Pi-hole blocklist assessment is limited by its strict avoidance of fabricating missing facts. It cannot evaluate sources lacking clear operational metadata or formatting signals, meaning it requires transparent data to assign accurate category and overlap risk.