birdbuddy - SKILL.md Agent Skill

name: birdbuddy description: Query your Bird Buddy smart bird feeder - check status, battery, food level, and see recent bird visitors with species identification. version: 1.0.0 metadata: openclaw: requires: env: - BIRDBUDDY_EMAIL - BIRDBUDDY_PASSWORD bins: - python3 primaryEnv: BIRDBUDDY_EMAIL emoji: "🐦" homepage: https://github.com/jhansche/pybirdbuddy

Bird Buddy Skill

Query your Bird Buddy smart bird feeder. Check feeder status, see recent bird visitors with species names, and fetch sighting photos.

Requirements

pybirdbuddy Python package: pip install pybirdbuddy
BIRDBUDDY_EMAIL and BIRDBUDDY_PASSWORD environment variables (email/password login only — Google SSO not supported)

Commands

Check feeder status (battery, food, signal)

python3 {skillDir}/run.py status

Get recent bird sightings with species names

python3 {skillDir}/run.py recent [hours=24] [limit=5]

Get raw postcard feed

python3 {skillDir}/run.py feed [hours=24]

Get full details and photo URLs for a specific postcard

python3 {skillDir}/run.py sighting <postcard_id>

Example agent interactions

"What birds visited my feeder today?" → recent 24 10
"How is my Bird Buddy doing?" → status
"Show me photos from the last visit" → recent 24 1 then sighting <id>
"What was the last bird at my feeder?" → recent 1 1