Agent skill · software engineering · sundial-org
pihole
pihole — an agent skill for coding agents.
Why this skill is useful
Provides specific API commands and configurations for controlling Pi-hole that the AI wouldn't reliably generate on its own.
What it needs
Requires pihole account access. About 3k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
Pi-hole Skill Control your Pi-hole DNS ad blocker via the Pi-hole v6 API. Setup Set your Pi-hole API configuration in Clawdbot config: Alternatively, set environment variables: Getting API Credentials 1. Open Pi-hole Admin at http://pi-hole.local/admin 2. Navigate to Settings > API 3. Generate an app password 4. Use that password as apiToken Capabilities Status Get current Pi-hole status (enabled/disabled) View stats: queries blocked, queries today, domains being blocked, active clients See recent query activity Controls Enable/Disable: Turn Pi-hole on or off Disable for 5 minutes: Temporarily disable ad blocking for a short period Disable for custom duration: Set specific disable time (in minutes) Block Analysis Check blocked domains: See what domains were blocked in a time window Show top blocked: Most frequently blocked domains Usage Examples API Endpoints (Pi-hole v6) Authentication Status Enable/Disable Stats Queries v5 vs v6 API Changes Pi-hole v6 introduced significant API changes: Feature v5 API v6 API --------- ---------- ---------- Base URL /admin/api.php /api Auth Token in URL/headers Session-based Status ?status /api/dns/blocking Stats ?summaryRaw /api/stats/summary Queries ?recentBlocked /api/queries Whitelist Supported via API Not available via API Important: Domain whitelisting is no longer available via the v6 API. You must whitelist domains through the Pi-hole Admin UI. SSL Certificates Production (Valid Cert) Self-Signed/Local Cert The insecure flag adds the -k option to curl to bypass certificate validation. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/pihole