Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    Shift Scheduler: Claude Skill for Staff Schedules

    2

    Optimized staff scheduling agent that solves complex constraints and generates payroll-ready exports.

    $5

    Secure checkout via Stripe

    Money-back guarantee

    Converts to your local currency at checkout

    Security scanned
    Shift Scheduler: Claude Skill for Staff Schedules

    Shift Scheduler: Claude Skill for Staff Schedules

    Example session with this skill installed

    I need a roster for a cafe with 4 baristas. Everyone needs 10h rest. Maya can't work weekends. We need 2 people for the 7am-3pm shift daily. Give me the cost if they all make $18/hr.

    • Read your context and instructions
    • Compiled the shift scheduler
    • Generated the data export

    I have processed the requirements for the cafe roster. The solver ran for 5 seconds and successfully filled all 14 slots for the week. Total labor cost is $2,016.00 for 112 paid hours. No rule violations were detected, and the 10-hour rest minimum was maintained for all staff.

    Weekly Shift Schedule

    DayShiftRoleAssignedStatus
    MonMorning (7a-3p)BaristaMayaConfirmed
    MonMorning (7a-3p)BaristaSamConfirmed
    TueMorning (7a-3p)BaristaMayaConfirmed
    TueMorning (7a-3p)BaristaAlexConfirmed
    WedMorning (7a-3p)BaristaMayaConfirmed
    WedMorning (7a-3p)BaristaJordanConfirmed
    ThuMorning (7a-3p)BaristaMayaConfirmed
    ThuMorning (7a-3p)BaristaSamConfirmed
    FriMorning (7a-3p)BaristaMayaConfirmed
    FriMorning (7a-3p)BaristaAlexConfirmed
    SatMorning (7a-3p)BaristaSamConfirmed
    SatMorning (7a-3p)BaristaJordanConfirmed
    SunMorning (7a-3p)BaristaAlexConfirmed
    SunMorning (7a-3p)BaristaJordanConfirmed

    Roster Statistics:

    • Maya: 40 hrs (Maxed)
    • Sam: 24 hrs
    • Alex: 24 hrs
    • Jordan: 24 hrs

    Next steps

    • Download the schedule.csv for your payroll records.
    • Distribute the individual .ics files found in the calendars/ folder to each barista.
    • If Maya needs to be capped at 30 hours instead, let me know to re-run the solver.

    schedule.csv

    CSV · data export

    Generated

    Example file from a real run - the skill writes it into your workspace.

    Connects securely to your tools. The creator never sees your data.

    About this skill

    Manual staff scheduling is a high-entropy constraint puzzle. Managers often waste hours balancing availability, labor laws, and overtime, only to accidentally double-book a barista or violate a rest-period rule. This skill replaces manual guesswork with a Python-based optimization engine that solves for every constraint simultaneously. It ensures you never schedule a "clopen" with under 10 hours of rest or exceed a part-timer's hour cap.

    What it does

    • Automated optimization uses a simulated annealing solver to fill shifts based on role qualifications and priority.
    • Constraint enforcement strictly honors availability windows, maximum weekly hours, and rest-between-shift rules.
    • Fairness balancing distributes weekend shifts across the team and respects individual worker preferences.
    • Conflict diagnostics provides a detailed report explaining exactly why specific slots remain unfilled.
    • Multi-format export generates printable HTML schedules, CSV files for payroll, and individual .ics calendar files for staff.

    How it works

    1. Input gathering where you feed the agent raw shift requirements, staff roles, wages, and availability windows.
    2. JSON generation that translates your business requirements into a structured schema for the optimization engine.
    3. Solver execution using the internal Python script to find the most cost-effective and compliant roster.
    4. Validation and reporting to verify all hard rules were met before presenting the final schedule and files.

    Frameworks & tools

    The solver is built with pure Python and requires no external dependencies. It uses a custom optimization engine (roster.py) to process JSON-based shift and staff data.

    Why this beats prompting it yourself

    Language models are notorious for "hallucinating" schedules that look correct but contain subtle rule violations, like double-booking staff or ignoring hour caps. This skill uses the LLM as an interface for a deterministic Python solver, guaranteeing that every output is mathematically verified against your hard constraints.

    Use cases

    • Hospitality management for balancing kitchen and floor staff across breakfast, lunch, and dinner rushes.
    • Retail operations to ensure adequate floor coverage while minimizing overtime during holiday peaks.
    • Clinic or salon scheduling where specific roles and certifications are required for every open slot.
    • Warehouse logistics for managing large teams with varying availability and strict safety rest requirements.

    Known limitations

    Overtime calculations are weekly only and do not account for daily overtime laws. ICS calendar files do not include time zone metadata. Not suitable for teams exceeding 50 people in a single weekly roster.

    Weekly overtime only; no daily OT logic. ICS files lack time zones. Optimization time increases with team size; best for under 50 staff per roster.

    How to use

    1. 1

      Connect your agent to the Agensi MCP

      Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup

    2. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before any payment.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill goes through the trust checks below.

    Security scanned

    Checked by our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    Money-back guarantee

    Doesn't do what its page promises? You get your money back.

    Trust & safety

    Security scan

    Security scan passed 1 month ago

    Requires

    macOS
    Python

    Permissions

    Terminal / Shell
    Listed1 month ago

    What's inside

    Frequently Asked Questions

    Standard AI models often make 'hallucination' errors in logic; this skill uses a specialized Python optimization engine to mathematically guarantee that no staff member is double-booked or scheduled against their set availability.

    The package includes the core scheduling agent interface, the proprietary Python-based optimization engine, and pre-formatted templates for importing your staff availability and shift requirements.

    Yes, you can define 'hard constraints' like maximum weekly hours and mandatory rest periods between shifts, as well as 'soft preferences' to ensure weekend shifts are distributed fairly across your team.

    This skill is optimized for Claude (via the Analysis Tool) and any AI agent environment that supports Python execution, as it relies on a deterministic script to solve the scheduling puzzle.

    While the solver is highly efficient, it is currently optimized for small to medium businesses; for best performance and accuracy, we recommend using it for teams of 50 staff members or fewer per roster.

    Once the schedule is generated, the skill provides a CSV file ready for payroll software, a printable HTML table for the breakroom, and individual .ics files so employees can sync their shifts to their phone calendars.

    New in Business & Operations