Guide · Agent skill
How to use the Log Employee Leave agent skill (log-leave)
Updated · written with AI from the project's own documentation and checked against our catalogue data
The log-leave skill is a short, structured intake for recording a new employee leave, such as FMLA, state leave, USERRA, or an ADA accommodation, in a local YAML register file. It asks a set of questions about the leave, looks up the entitlement for the relevant jurisdiction, and calculates the first upcoming deadline. This guide explains what the skill does, how to install it, how to trigger it with natural requests, and what it needs before you rely on it.
Quick start
- 1Download the ZIP. Download the log-leave ZIP from this page.
- 2Install the skill. Unzip it into ~/.claude/skills/ for personal use or a project's .claude/skills/ folder, or upload it in the Claude apps under Settings → Capabilities → Skills.
- 3Set up the employment-legal plugin. Make sure the claude-for-legal employment-legal plugin and its CLAUDE.md jurisdiction table and Systems section are configured under ~/.claude/plugins/config/.
- 4Check the jurisdiction table. Confirm the entitlements in the jurisdiction table match the rules you need to follow, since you maintain this table.
- 5Describe the leave. Run /employment-legal:log-leave or describe the leave in plain language, including employee or role, leave type, jurisdiction and start date.
- 6Answer the batch of questions. Reply to the single prompt covering start date, intermittent status, expected return, and designation and certification status.
- 7Confirm the logged entry. Check the one-line confirmation and the first deadline it reports; the leave tracker will alert on deadlines.
What the log-leave skill makes the agent do
An agent skill is a folder containing a SKILL.md file with instructions that an AI assistant follows when a matching request comes up. The log-leave skill tells the assistant how to add a new leave entry to a leave register so that deadlines can be tracked from the start of the leave.
When it runs, the assistant reads your jurisdiction table and Systems section from the employment-legal CLAUDE.md file, asks one batch of questions about the leave, looks up the applicable entitlement, and works out the first deadline. It then writes the entry to leave-register.yaml and confirms what was logged.
- Asks all questions in a single prompt: employee name or role, work state, leave type, start date, whether it is intermittent, expected return date, and the status of the designation notice and medical certification.
- Calculates the first deadline: 5 business days from leave start if the designation notice has not been sent, 15 days from request date if medical certification was requested but not received, or the 75% exhaustion point if both are sent and received.
- Creates leave-register.yaml if it does not already exist.
Install the log-leave skill
Download the ZIP for the log-leave skill from this page. You can install it in one of two ways, depending on where you use Claude.
For Claude Code, unzip the file into your personal skills folder at ~/.claude/skills/, or into a project's .claude/skills/ folder if you want the skill available only in that project. For the Claude apps, upload the ZIP under Settings, then Capabilities, then Skills.
- Personal install: unzip into ~/.claude/skills/
- Project install: unzip into the project's .claude/skills/ folder
- Claude apps: Settings → Capabilities → Skills, then upload the ZIP
Set up the required plugin and configuration
The skill does not work on its own. It depends on the claude-for-legal employment-legal plugin with its configuration files in place under ~/.claude/plugins/config/. It also needs a leave-tracker agent that defines the leave register format, because the skill writes entries in that format.
The skill reads two parts of the employment-legal CLAUDE.md file: the jurisdiction table, which gives leave entitlements, and the Systems section. The jurisdiction table is maintained by you, so check that the entries match the rules that apply to your organisation.
- ~/.claude/plugins/config/claude-for-legal/employment-legal/CLAUDE.md with a jurisdiction table and Systems section
- ~/.claude/plugins/config/claude-for-legal/employment-legal/leave-register.yaml (created by the skill if missing)
- A leave-tracker agent that defines the leave register format
~/.claude/plugins/config/claude-for-legal/employment-legal/CLAUDE.mdTrigger the skill with a natural request
You can invoke the skill directly with its slash command, or describe the leave in plain language and let the assistant pick the skill up. The skill's argument hint asks you to describe the leave, including the employee or role, the leave type, the jurisdiction, and the start date.
Give as much of the basic detail as you have in one message. Anything you leave out, the assistant will ask for in its single batch of questions.
- Include the employee or role (anonymised is fine).
- State the leave type and, for state leave, which state.
- Give the start date and whether the leave is intermittent.
/employment-legal:log-leaveExample: logging a new leave
The skill's own example shows a request with the employee's role, work state, leave type, and status. You can copy this pattern and replace the details with your own case.
After you answer the questions, the assistant calculates the first deadline and confirms the entry in one line, stating that the leave tracker will alert automatically.
/employment-legal:log-leave
Sarah (Sr. Engineer, works in California) just started FMLA today for a
serious health condition. Intermittent. No designation sent yet.Safety notes: scripts, network and sensitive data
The log-leave skill runs no scripts and uses no network connection. Everything it does is reading configuration files and writing one register file on your machine.
The questions touch on health conditions and medical certification. Before you use the skill, decide whether that information may be entered into an AI tool in your organisation. The skill suggests anonymised employee details, and you should only enter what your policy allows.
- Runs scripts: no
- Uses network: no
- Files on disk: the register and configuration files listed above
- Medical details: the questions cover health conditions and certification, so check your policy first
What people use it for
- Logging a new FMLA leave for an employee and seeing when the designation notice is due.
- Recording a state leave with its entitlement looked up from the jurisdiction table.
- Starting a register entry for an ADA accommodation or USERRA leave so the tracker watches its clocks from day one.
- Tracking an intermittent leave whose certification has been requested but not yet received.
Frequently asked questions
Is the log-leave skill free?
The source does not state pricing or licence terms for the skill beyond its Apache-2.0 licence, which is listed for the repository. Check the licence file in the repository for the terms that apply.
What do I need before I can use log-leave?
You need the claude-for-legal employment-legal plugin with its CLAUDE.md jurisdiction table and Systems section configured under ~/.claude/plugins/config/, plus a leave-tracker agent that defines the leave register format.
Where do I install the log-leave skill?
Unzip it into ~/.claude/skills/ for personal use or into a project's .claude/skills/ folder. In the Claude apps, upload the ZIP under Settings → Capabilities → Skills.
Does log-leave give legal advice on leave eligibility?
No. It is a record-keeping tool for employers. It relies on a jurisdiction table you maintain, which may be incomplete or out of date, so a lawyer should verify the entitlements and deadlines.
Does the skill send my data anywhere?
The skill runs no scripts and uses no network connection. It reads configuration files and writes to leave-register.yaml on your machine.
What is the alternative if I do not use the claude-for-legal plugin?
The source does not describe other tools. Without the plugin's configuration and leave-tracker format, this skill will not work as described, so you would need a separate way to track leave deadlines.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use log-leave if you are an HR or employment team that wants a quick, structured intake for new leave cases and already uses the claude-for-legal employment plugin with its configuration set up. Do not use it for final legal advice on eligibility or deadlines, for personal leave rights guidance from employees, or where medical details must stay out of AI tools.
Download the skill