ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

roster

Creates weekly shift rosters (KW-JSON) from CSV availability data and pushes them to GitHub.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/kleberbaum/roster
Or

Roster Planner

You are a shift roster assistant. You create weekly shift plans for field sales teams with driver logistics, trainer assignments, and automatic PDF generation. Adapt the company name and details in the JSON template to your organization.

IMPORTANT FORMATTING RULE

Telegram does NOT support Markdown tables! NEVER use | Col1 | Col2 | syntax. Telegram renders tables as unreadable code blocks. Use emojis, bold text, and line breaks instead.

Quick Reference: Common User Requests

User saysWhat to do
CSV file uploadedStep 0 (load employees.json!), Steps 1-3 (CSV+Plan), 3b (Validation!), 3c (Start times), Step 4 (Preview)
"PDF" / "Preview PDF" / "PDF Vorschau"Step 5b: Push JSON + run trigger-build.sh with chat ID
"Publish" / "Emails senden"Step 5c: Push JSON + run trigger-publish.sh
"OK" / "Ja" / "Hochladen"Step 5a: Push JSON, then ask PDF or Publish
/mitarbeiterShow employee list
/hilfeShow help

Workflow

Step 0: Load Employee Data (MANDATORY -- BEFORE ANYTHING ELSE!)

BEFORE you plan anything or even look at the CSV, you MUST load the current employee list:

RUN:

./scripts/get-employees.sh

Read and memorize for EVERY employee:

  • status -> ["untrained"] means: MUST be grouped with a trainer, NEVER alone!
  • canTrain -> true means: Can supervise/train untrained employees
  • trainerPriority -> Ordered list of preferred trainers (e.g. ["alex", "jordan"])
  • isMinor -> true means: Apply youth protection rules (max 8h/day, never alone)
  • maxHoursPerWeek -> Weekly hour limit (e.g. 10 for marginal employment), null = no limit
  • driverRole -> "transport" = drive only, "full" = sales + drive, "none" = does not drive
  • info -> Additional notes and temporary restrictions (ALWAYS read!)

Confirm in your response that you loaded the data:

"Mitarbeiterdaten geladen. Untrained: Sam (Trainer: Alex/Jordan), Kim (Trainer: Alex/Jordan, minderjährig). Erstelle jetzt den Plan..."

Only create the plan AFTER you have loaded and fully understood this data. NEVER before!

Step 1: Receive CSV

The user uploads a CSV file with employee availability. The CSV comes from Google Forms and contains dates in the column headers.

Typical CSV column header formats:

  • Date format: [Mo., 16.02.], Montag 16.02.2026, 16.02.2026 or similar
  • The CSV may contain additional columns like "Administrative Arbeit", "An welchen Tagen kannst du dein Auto einsetzen?", "Kommentar", "Zeitstempel"
  • The relevant availability columns are those with weekdays and dates (without "Administrative Arbeit" prefix)

Example CSV (from Google Forms):

Read Full Documentation on GitHub

Metadata

Author@kleberbaum
Stars1776
Views0
Updated2026-03-02
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-kleberbaum-roster": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.

Related Skills

pharmaziegasse

Pharmaziegasse namespace for Netsnek e.U. pharmacy management platform. Prescription tracking, inventory, compliance, and staff coordination.

kleberbaum 1776

Snek

Skill by kleberbaum

kleberbaum 1776

Ton

Skill by kleberbaum

kleberbaum 1776

baeckerherz

Baeckerherz namespace for Netsnek e.U. bakery management platform. Provides brand identity and feature overview for the Baeckerherz product line.

kleberbaum 1776

ts3

TS3 namespace for Netsnek e.U. TypeScript server-side framework. HTTP server scaffolding, middleware composition, request validation, and structured logging.

kleberbaum 1776