breezy_skill

Overview

This skill integrates with Breezy HR to manage jobs, candidates, stages, users, and related hiring data. It exposes common operations like creating and updating positions, searching and moving candidates through pipelines, and retrieving company or user information. Use it to automate recruiting workflows and connect Breezy data into other systems.

How this skill works

The skill talks to Breezy HR through the Membrane CLI which handles authentication, credential refresh, and proxying. You create or reuse a Membrane connection, discover available actions (pre-built API wrappers), and run actions with JSON inputs. When needed, you can send raw proxied requests through Membrane for endpoints not covered by actions.

When to use it

• Automate candidate intake, status updates, and notes across positions
• Sync job postings and position details from another system into Breezy
• Search or export candidate lists and pipeline stages for reporting
• Build hiring automations that move candidates through stages or notify stakeholders
• Create or update users, teams, and position assignments programmatically

Best practices

• Prefer Membrane actions over raw API calls to leverage built-in auth, pagination, and error handling
• Run membrane action list --intent=QUERY to discover existing actions before crafting custom requests
• Store and reuse a Membrane connection rather than exchanging API keys or tokens
• Use Membrane proxy requests only when a pre-built action does not exist for your endpoint
• Pass structured JSON to actions and validate required fields to avoid partial updates

Example use cases

• Create a new position and assign hiring team automatically when a requisition is approved
• Search candidates by email across all positions and add a note to a matching candidate
• Move a candidate to the next stage after a successful interview and trigger a notification workflow
• Export all candidates in a pipeline to a reporting system on a schedule
• Update position state (publish/close) from an external job-board integration