Guide · Agent skill
How to use the Wage & Hour Q&A agent skill (wage-hour-qa)
Updated · written with AI from the project's own documentation and checked against our catalogue data
The wage-hour-qa skill is a set of instructions that teaches an AI agent to answer employment-law questions about overtime, exemption status, meal and rest breaks, leave and final paycheck timing for a specific state or country. Instead of answering from memory, the agent is told to research the currently operative rule, cite the primary source, note effective dates and flag close calls for attorney review. This guide explains what the skill does, how to install it, how to trigger it and what to watch for, so you can use it for a first-pass research answer before you act.
Quick start
- 1Download the ZIP. Get the wage-hour-qa ZIP from the skill's page on this site.
- 2Unzip into a skills folder. Unzip into ~/.claude/skills/ for personal use or into the project's .claude/skills/ folder for one project.
- 3Or upload in the Claude apps. In the Claude apps, go to Settings → Capabilities → Skills and upload the skill.
- 4Set up the footprint file. Make sure the employment-legal CLAUDE.md jurisdictional footprint file exists at the path the skill expects.
- 5Connect a research tool. Configure a legal research tool such as Westlaw, CourtListener or a firm platform.
- 6Ask a wage-hour question. Ask in plain language or run /wage-hour-qa with your question, naming the jurisdiction and facts.
- 7Verify the citations. Check tagged citations, especially those marked verify, and take close calls to an employment attorney.
What the skill makes the agent do
Once installed, the skill changes how the agent handles wage-and-hour questions. It first loads a jurisdictional footprint file, then identifies which state or country the question is about. If the jurisdiction is not stated, the agent is instructed to ask. It then researches the controlling rule rather than stating it from memory, because thresholds, exemption criteria and final-pay timing change often and vary by state.
The skill's answer is meant to include a citation for the controlling primary source (statute, regulation, wage order or case), the effective date, and a note on whether the rule has been recently amended or is in litigation. Where the agent cannot verify the current law, it is instructed to say so and flag the question for attorney verification.
Install the wage-hour-qa skill
Download the ZIP from the skill's page on this site. Then choose one of two routes.
For a personal install, unzip the file into ~/.claude/skills/. For a single project, unzip it into the project's .claude/skills/ folder. Alternatively, if you use the Claude apps, upload the skill under Settings → Capabilities → Skills.
- Personal: unzip into ~/.claude/skills/
- Project only: unzip into .claude/skills/ inside the project
- Claude apps: Settings → Capabilities → Skills, then upload
Set up the jurisdictional footprint file
The skill expects a claude-for-legal employment-legal CLAUDE.md file that describes your jurisdictional footprint, meaning the states or countries where your employees work. The skill loads it from ~/.claude/plugins/config/claude-for-legal/employment-legal/CLAUDE.md. If the question does not name a jurisdiction, the agent can use this file to decide which jurisdictions to research, or it can ask you.
~/.claude/plugins/config/claude-for-legal/employment-legal/CLAUDE.mdConnect a legal research tool
The skill is built around a configured legal research tool such as Westlaw, CourtListener or a firm research platform. Web search is optional. If the research tool returns few or no results, the skill is designed to stop and report what it found rather than fill the gap from web search or model knowledge. It will then offer options, such as broadening the query, trying another tool, or running a web search whose results are tagged for verification.
Trigger the skill with natural requests
The skill description lists phrases that should activate it. You can ask in plain language, for example: what the rule is in a given state, whether a role is exempt, whether you must pay overtime for a specific situation, or whether you can classify a worker a certain way. You can also invoke it directly with /wage-hour-qa followed by your question, since the skill accepts a question as its argument.
- "What's the rule in California for meal breaks?"
- "Is this operations manager exempt?"
- "Do we have to pay overtime for hours worked at home?"
- "Can we classify this person as a contractor?"
- /wage-hour-qa [your question]
Read the answer and its source tags
Every citation in an answer is tagged by where it came from. Tags include [Westlaw], [CourtListener], the name of a connector tool, [web search — verify], [model knowledge — verify] and [user provided]. Citations tagged verify carry higher fabrication risk and should be checked against a primary source first. Do not remove these tags before sharing the answer.
For back-pay or unpaid-overtime calculations, the skill uses a scaffold based on the FLSA regular rate rather than a simple hourly wage times overtime hours. It asks you to state which pay posture you are assuming before it computes, and the answer should be checked by counsel.
Safety notes: scripts and network access
This skill does not run scripts. It does use the network, because its purpose is to query legal research tools and, optionally, the web. Review the research connectors you enable and the material you send to them, especially if it contains confidential employee information.
- Runs scripts: no
- Uses network: yes, for legal research and optional web search
- Matter files are written to a matter folder only when matter workspaces are enabled
Tips for better answers
State the state or country and the facts in the question, such as pay basis, hours, job duties and whether the worker was paid for overtime hours. The skill's own guidance is that close calls and shifting law need human judgment, so treat its output as a researched first draft to take to counsel.
- Name the jurisdiction in the question
- Include salary, duties and pay structure for exemption questions
- Say whether bonuses or commissions were paid for back-pay questions
- Check every [web search — verify] or [model knowledge — verify] citation before relying on it
What people use it for
- An HR team checks whether an overtime-eligible role can be classified as exempt before changing pay.
- A manager asks whether overtime is owed for a shift and then confirms the answer with counsel.
- An employment lawyer gets a researched first draft with citations tagged by source to review.
- A team checks final paycheck timing for a termination versus a resignation in a specific state.
- A payroll team scopes a back-pay question using the regular-rate scaffold before computing amounts.
Frequently asked questions
How do I install the wage-hour-qa skill?
Download the ZIP from the skill's page on this site. For a personal install, unzip it into ~/.claude/skills/, or into .claude/skills/ inside a project for one project only. In the Claude apps, you can instead upload it under Settings → Capabilities → Skills.
What does the wage-hour-qa skill require to work?
It requires a claude-for-legal employment-legal CLAUDE.md file describing your jurisdictional footprint, and a configured legal research tool such as Westlaw, CourtListener or a firm platform. Web search is optional and its results are tagged for verification.
Is the wage-hour-qa skill free?
The source material provided for this page does not state pricing or licence terms beyond the licence listed as Apache-2.0. Check the licence file in the source repository for the terms that apply.
Can the wage-hour-qa skill replace an employment lawyer?
No. The skill itself says close calls and shifting law need human judgment, so it is meant to produce a researched first draft. It is not a substitute for a licensed employment attorney on a live dispute.
Why does the skill stop instead of answering when research results are thin?
The skill is designed not to fill gaps from web search or model memory without asking. When a research query returns few results, it reports what it found and offers options, so a lawyer can decide whether to accept lower-confidence sources.
Does the wage-hour-qa skill run scripts or access the network?
It does not run scripts. It does use the network, to query legal research tools and optionally search the web, so review which connectors you enable.
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 this skill if you are an in-house HR or legal team, an employment lawyer or a manager who needs a researched, cited first pass on a wage-and-hour question before acting. Pick something else if you need a final answer on a live dispute, or if you cannot connect a legal research tool, because the skill is built to stop rather than fall back to memory.
Download the skill