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".
Security Analysis
high confidenceThe skill's code and instructions match its stated purpose (reading the Pi-hole FTL DB and invoking pihole CLI); nothing in the package attempts network exfiltration or unrelated access, though a small metadata omission is noted.
The skill claims to query the Pi-hole FTL DB and control the pihole CLI. The included script reads /etc/pihole/pihole-FTL.db and returns JSON; management actions are intended to be performed with the system 'pihole' CLI. This is coherent with the description, but the package metadata lists no required binaries even though the SKILL.md and scripts expect python3 and (for management operations) the 'pihole' CLI and appropriate system privileges.
Runtime instructions are narrowly scoped: read-only queries of the local /etc/pihole/pihole-FTL.db (script opens DB in read-only mode) and optionally run pihole CLI commands for enable/disable/update. The skill does not instruct the agent to read unrelated files, transmit data to external endpoints, or access credentials.
No install spec (instruction-only with a small helper script). No downloads or archive extraction. Minimal on-disk footprint and no installer-based risks.
The skill requests no environment variables or credentials. It does require the agent/user to have read access to /etc/pihole/pihole-FTL.db and (for management actions) sudo or membership in the pihole group. These filesystem and privilege needs are proportional to the stated tasks, but the metadata should have declared required binaries (python3 and 'pihole') to avoid surprise.
The skill is not always-enabled and does not request system-wide persistence. Model invocation is allowed (normal default). Be aware that if the agent is allowed to invoke skills autonomously, this skill could run local pihole commands that require elevated privileges — limit those permissions to trusted contexts.
Guidance
This skill appears to do what it says: query the local Pi-hole FTL DB and call the pihole CLI. Before installing, verify you have python3 and the pihole CLI on the host; the metadata omits these required binaries. Do not grant sudo or add the agent's user to the pihole group unless you trust the skill and the environment — management commands (enable/disable/gravity) need elevated privileges. Because the skill's source/homepage are unknown, inspect the included script (small and readable) yourself; it opens the DB in read-only mode and prints JSON and does not contact external servers. If you want stricter safety, restrict the agent's ability to run privileged commands and only grant read access to /etc/pihole/pihole-FTL.db.
Latest Release
v1.0.1
pihole-ctl 1.0.1 - Updated SKILL.md to clarify script requirements and permissions. - Added guidance for database read access and recommended group membership. - Noted that management commands may require sudo or proper user privileges. - Improved script description for clearer usage.
More by @1999AZZAR
Published by @1999AZZAR on ClawHub
