Staff Scheduler

Build optimized staff schedules that match coverage to demand while respecting labor budgets, employee availability, and local labor laws. Handles shift swaps, time-off requests, and identifies over/under-staffing before it happens.

492 stars 68 forksOther

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add cosmicstack-labs/mercury-agent-skills --skill staff-scheduler
Manual install
git clone --depth 1 https://github.com/cosmicstack-labs/mercury-agent-skills.git /tmp/mercury-agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/mercury-agent-skills/categories/shop-restaurant/staff-scheduler ~/.claude/skills/staff-scheduler

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Staff Scheduler

## Core Principles

Labor is typically the second-largest cost (after COGS) for any shop or restaurant — often 25-35% of revenue. A well-built schedule balances three things: **customer demand** (you need enough bodies), **labor budget** (you can't overspend), and **employee satisfaction** (fair schedules retain good staff). The Staff Scheduler skill automates this balancing act.

### The Three Pillars of Great Scheduling

1. **Demand-driven coverage.** Schedule to the forecast, not to habit. If Mondays are slow, don't staff for Saturday volumes.
2. **Labor cost targeting.** Set a target labor % (e.g., 28% of sales) and build the schedule to hit it. Every hour above target eats margin.
3. **Fairness & compliance.** Respect availability, distribute desirable shifts equitably, and stay within labor law constraints (breaks, overtime, minors).

---

## Skill Workflow

### Step 1 — Gather Baseline Data

Ask the user for:

- **Staff roster:** Names, roles (server, cook, cashier, manager), hourly rates
- **Availability:** Days/times each person can work (and cannot)
- **Sales forecast:** Projected daily covers or revenue for the scheduling period
- **Labor target:** Target labor cost as % of sales (e.g., 28%)
- **Coverage requirements:** Staff needed per role per shift (e.g., "2 servers, 1 cook, 1 cashier for lunch")

**If they don't have a sales forecast:**
Read the full skill on GitHub

Details

Skill name
staff-scheduler
Path
categories/shop-restaurant/staff-scheduler/SKILL.md
License
MIT
Repo updated
25 August 2026

FAQ

What does the Staff Scheduler skill do?

Build optimized staff schedules that match coverage to demand while respecting labor budgets, employee availability, and local labor laws. Handles shift swaps, time-off requests, and identifies over/under-staffing before it happens.

How do I install the Staff Scheduler skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add cosmicstack-labs/mercury-agent-skills --skill staff-scheduler. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Staff Scheduler popular?

It lives in cosmicstack-labs/mercury-agent-skills, which has 492 GitHub stars and 68 forks.

Related skills

Browse the most popular Claude skills, all other skills, or write your own with the skills generator.