---
author: 'Vinicius Nascimento'
description:
  'Calculate elapsed work time from the Long Day Factory shift record. Use when
  the user asks whether they can leave or how much time remains.'
extras:
  'Add tests for malformed JSON, overnight shifts, and a lunch end before lunch
  start.'
focus: 'Calculate working time after lunch handling.'
id: 'am-i-free'
improve:
  - 'Replace host-specific `$CLAUDE_SKILL_DIR` fallback paths with
    package-relative paths.'
  - 'Document the data schema and timezone/DST assumptions in a reference.'
  - 'Any `--default-lunch` write must ask for consent immediately before it
    occurs.'
name: 'am-i-free'
path: '../submitted-skills/Vinicius%20Nascimento/skills/am-i-free/SKILL.md'
status: 'Good companion set'
title: 'Am I free?'
wins:
  - 'Exit-code handling makes the agent’s next action deterministic.'
  - 'Friendly, human output matches the domain.'
---

# am-i-free

## Workflow

1. Run `python3 scripts/am_i_free.py`.
2. Interpret its documented exit code. Ask before any option that writes an
   assumed lunch break.
3. Give the result, remaining time or release time, and a concise friendly
   message.

## Rules

- Treat malformed or missing state as a recovery question, not a calculation.
- Read `references/state.md` for schema and timezone behavior.
- Do not expose unrelated content from the local state file.

## Output

Report calculation status, remaining time or freedom, and any assumption made.
