How do I install the Pihole Ctl skill?

Run npx skillmds@latest add 1999azzar/pihole-ctl in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Pihole Ctl safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Pihole Ctl?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Pihole Ctl free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Pihole Ctl?

1999AZZAR (@1999azzar) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Pihole Ctl by 1999azzar — Agent Skill

Name: Pihole Ctl
Rating: 4.666666666666667 (3 reviews)
Author: 1999AZZAR

File contents

Pi-hole Controller

Usage

Role: Network Guardian.
Trigger: "Check Pi-hole", "Adblock status", "Who is querying top domains?".
Output: JSON stats or CLI command results.

Capabilities

Statistics: Query FTL database for accurate logs (Last 24h, Top Domains).
Management: Enable/Disable blocking (pihole enable/disable).
Blocklists: Update Gravity (pihole -g).
Audit: Identify chatty clients or top blocked domains.

Safety & Approval Gates

The following actions affect the entire local network and require explicit human confirmation before execution:

Action	Risk	Gate
`pihole disable`	⚠️ HIGH — Disables DNS blocking network-wide	Requires human approval
`pihole -g` (gravity update)	MEDIUM — Temporarily disrupts DNS resolution	Requires human approval
Database queries (read-only)	LOW	No gate required
`pihole status` / `pihole enable`	LOW	No gate required

Note: The agent MUST NOT disable Pi-hole without explicit user confirmation, as this removes DNS-level protection for all devices on the network.

Scripts

scripts/query_db.py: Python script using native sqlite3 library to query Pi-hole stats safely.
- Requires read permission on /etc/pihole/pihole-FTL.db.
- Usage: python3 scripts/query_db.py --summary --hours 24
- Usage: python3 scripts/query_db.py --top 10

Permissions

Database Access: The user running this skill must have read access to /etc/pihole/pihole-FTL.db.
- Recommended: Add user to pihole group (usermod -aG pihole ubuntu).
Management Commands: pihole CLI commands (enable/disable) require sudo or must be run by a user with appropriate permissions.

Reference Materials

Database Schema

---name: pihole-ctldescription: Manage and monitor local Pi-hole instance. Query FTL database for statistics (blocked ads, top clients) and control service via CLI. Use when user asks "how many ads blocked", "pihole status", or "update gravity".---# Pi-hole Controller## Usage- **Role**: Network Guardian.- **Trigger**: "Check Pi-hole", "Adblock status", "Who is querying top domains?".- **Output**: JSON stats or CLI command results.## Capabilities1. **Statistics**: Query FTL database for accurate logs (Last 24h, Top Domains).2. **Management**: Enable/Disable blocking (`pihole enable/disable`).3. **Blocklists**: Update Gravity (`pihole -g`).4. **Audit**: Identify chatty clients or top blocked domains.## Safety & Approval GatesThe following actions affect the entire local network and **require explicit human confirmation** before execution:| Action | Risk | Gate || --- | --- | --- || `pihole disable` | ⚠️ HIGH — Disables DNS blocking network-wide | **Requires human approval** || `pihole -g` (gravity update) | MEDIUM — Temporarily disrupts DNS resolution | **Requires human approval** || Database queries (read-only) | LOW | No gate required || `pihole status` / `pihole enable` | LOW | No gate required |> **Note**: The agent MUST NOT disable Pi-hole without explicit user confirmation, as this removes DNS-level protection for all devices on the network.## Scripts- `scripts/query_db.py`: Python script using native `sqlite3` library to query Pi-hole stats safely. - Requires read permission on `/etc/pihole/pihole-FTL.db`. - Usage: `python3 scripts/query_db.py --summary --hours 24` - Usage: `python3 scripts/query_db.py --top 10`## Permissions- **Database Access**: The user running this skill must have read access to `/etc/pihole/pihole-FTL.db`. - Recommended: Add user to `pihole` group (`usermod -aG pihole ubuntu`).- **Management Commands**: `pihole` CLI commands (enable/disable) require `sudo` or must be run by a user with appropriate permissions.## Reference Materials- [Database Schema](references/db-schema.md)

Frequently asked questions

Pihole Ctl