myco:add-tool-category
Installation
SKILL.md
Adding a New Tool Category to unifi-mcp
A "tool category" is a new UniFi resource type — DNS records, DHCP leases, alarms, etc. — exposed end-to-end: a manager class that talks to the controller, a schema/validator layer, a tool module that Claude calls, and tests at both layers. Omitting any step silently breaks CI or corrupts data on live controllers.
Golden-path reference implementation: managers/dns_manager.py + tools/dns.py + test_dns_manager.py + test_dns_tools.py (PR #128).
Prerequisites
- Understand which UniFi package owns the resource:
unifi-network-mcpvs.unifi-protect-mcpvs.unifi-access-mcp. Directory structure and naming conventions differ by package. - Know whether the resource's GET-by-ID endpoint returns 405 (see Step 2).
- Review
implement-update-tool-fetch-merge-putskill before writing any update method. - Have a live controller available for final validation output in the PR description.
- Understand
UniFiValidatorRegistry.validate()usage patterns (covered in Step 3).
Step 1 — Create the Manager Class
File: apps/{package}/managers/{resource}_manager.py