Smart Scheduler

Use this skill when the user wants the agent to coordinate meeting requests,

track proposed time slots, confirm a final booking, or export an ICS file for a

scheduled meeting.

When to Use

• Creating a new scheduling request from a conversation.
• Recording candidate meeting times from different participants.
• Confirming the final slot after agreement.
• Exporting a calendar file that can be shared or imported.

Commands

The helper script stores state in {baseDir}/.runtime/smart-scheduler.db.

Create a request

python {baseDir}/scripts/smart_scheduler.py create-request --title "Weekly sync" --organizer "Mehul" --timezone "Europe/Berlin" --duration-minutes 30 --participant "Priya|telegram|@priya" --participant "Marco|email|marco@example.com"

Propose time slots

python {baseDir}/scripts/smart_scheduler.py propose-slots --request-id 1 --slot "2026-03-25T09:00|2026-03-25T09:30" --slot "2026-03-25T16:00|2026-03-25T16:30" --source "scheduler-negotiation"

Confirm a slot

python {baseDir}/scripts/smart_scheduler.py confirm-slot --request-id 1 --slot-id 2 --confirmed-by "Priya"

Export ICS

python {baseDir}/scripts/smart_scheduler.py export-ics --request-id 1 --output {baseDir}/.runtime/weekly-sync.ics

Safety Boundaries

• Never mark a slot confirmed unless the user or participant explicitly chose it.
• Keep time zone strings exactly as provided instead of guessing silently.
• If the schedule is ambiguous, present the unresolved options rather than inventing agreement.
• Do not overwrite an existing booking without saying so clearly.