Skill596 repo starsupdated 3d ago
hr-handbook
Generate employee handbook sections covering required-by-law policies (EEO, anti-harassment, ADA accommodation, FMLA, lactation, voting/jury/military, pay transparency, whistleblower, at-will + handbook-not-a-contract, NLRA §7 carve-outs) and standard-but-optional perks. Templates only - not employment-law advice.
Install in Claude Code
Copygit clone --depth 1 https://github.com/FerroxLabs/wayland /tmp/hr-handbook && cp -r /tmp/hr-handbook/resources/bundled-extensions/business-hr/skills/hr-handbook ~/.claude/skills/hr-handbookThen start a new Claude Code session; the skill loads automatically.
Definition
SKILL.md
> **Templates only - not employment-law advice.** Employee handbook policies are state-specific and rapidly changing - Have HR counsel review before publishing or distributing. # HR - Employee Handbook Generate clear, professional, **legally-defensible** employee handbook sections. ## Pre-flight 1. **State(s) of employment** (drives state-specific requirements) 2. **Country** (US handbook structure differs from UK/EU) 3. **Total headcount** (FMLA 50+, Title VII 15+, etc.) 4. **Federal contractor status** (OFCCP additional requirements) 5. **Any cannabis/recreational-use jurisdiction** (CA, CT, IL, MT, NJ, NV, NY, RI, WA + DC require off-duty protections) ## Usage ``` /hr handbook <section topic> ``` ## Two tables: required-by-law vs standard-but-optional ### Required-by-law sections (every US handbook should have) | Section | Why it's required / strongly recommended | |---------|------------------------------------------| | **EEO / Anti-Discrimination policy** | Title VII / ADEA / ADA / GINA / state FEPAs; affirmative-action contractors required | | **Anti-Harassment with reporting + non-retaliation** | CA FEHA explicit requirement (2 CCR §11023); Faragher/Ellerth defense in any harassment case | | **ADA reasonable-accommodation request process (interactive)** | ADA + state equivalents; failure to engage = automatic loss | | **Religious accommodation** | *Groff v. DeJoy* (2023) raised standard from "de minimis" to "substantial burden" | | **Pregnancy / PWFA accommodation** | PWFA (June 2023, 15+ EE) + state PFLA-like statutes | | **Lactation accommodation** | PUMP Act (2022) - federal, nearly all employers; private space + reasonable break time | | **FMLA + state PFML** | FMLA at 50+ EE; state PFML thresholds vary (CA CFRA 5+, NY 1+, etc.) | | **PTO / sick leave** | State paid-sick-leave laws (CA, AZ, CO, CT, IL, ME, MA, MD, MI, MN, NJ, NM, NV, NY, OR, RI, VT, WA + cities) | | **Voting / jury duty / military leave (USERRA)** | State voting-leave laws; federal USERRA | | **Domestic-violence leave** | CA, NY, IL, KS, RI, others | | **Pay transparency / right to discuss wages** | NLRA §7 - handbooks regularly violate this with confidentiality clauses; explicit carve-out required | | **Whistleblower / SOX protection** | SOX, Dodd-Frank, state whistleblower acts | | **At-will disclaimer + handbook-not-a-contract** | Case-law-driven; without it, handbook may be construed as contract | | **NLRA §7 carve-outs** in confidentiality, social-media, off-duty-conduct sections | Handbook policies that "chill" §7 activity are unfair labor practices | | **Social media + off-duty conduct** | NLRA §7 limits employer rights; CA Lab. Code §96(k) protects off-duty lawful conduct | | **Drug & alcohol** with cannabis-jurisdiction nuance | NY Lab. §201-d, NJ CREAMM, CT, NV - recreational-use protection; CA AB 2188 (2024) | | **Open-door / grievance process** | Faragher/Ellerth defense | | **Records access** | GDPR Art. 15 (1-month response), CA CPRA (employee data rights since Jan 1 2023) | | **Anti-retaliation** | EEOC, FMLA, OSHA, NLRA, FLSA all have anti-retaliation provisions | | **Acknowledgment receipt** | Legal hook for handbook enforceability + at-will reaffirmation | ### Standard-but-optional perks sections | Section | Coverage | |---------|----------| | Remote work / WFH | Equipment stipend, location restrictions, tax considerations | | Parental leave (paid) | If exceeding statutory minimum | | Bereavement | Number of days, family definition | | Sabbatical | Eligibility, duration, pay continuation | | Professional development | Learning budget, conference policy, tuition | | Wellness / EAP | Employee assistance program, wellness stipend | | Travel | Booking, accommodations, international | | Equipment / BYOD | Laptop policy, software requests | | Conflicts of interest | Outside employment, vendors, investments | | Performance management | Review cadence, ratings, PIP framework | ## Output Format ```markdown ## [Section Title] **Last Updated:** [Date] | **Owned By:** People / HR | **Jurisdiction:** [State, Country] ### Policy Statement [1-2 sentence summary of what this policy covers and who it applies to] ### Details #### [Subsection 1] [Policy text - clear, plain language, specific where it needs to be] #### [Subsection 2] [Policy text] ### How It Works [Step-by-step process if applicable - e.g., how to request PTO, how to file an expense] ### Eligibility [Who this applies to - full-time, part-time, contractors, by tenure, etc.] ### Anti-retaliation Employees are protected from retaliation for reporting concerns, requesting accommodations, taking protected leave, or participating in any investigation, under federal and state law including [Title VII, ADA, ADEA, FMLA, OSHA, NLRA, state FEPA]. Report retaliation to [contact]. ### NLRA §7 carve-out (where relevant) Nothing in this policy restricts employees' rights to (i) discuss wages, hours, or terms and conditions of employment with co-workers, (ii) communicate with government agencies (NLRB, EEOC, OSHA, SEC, DOL, state DOL), (iii) exercise Section 7 rights under the National Labor Relations Act, or (iv) testify truthfully under oath. ### Exceptions [When the standard policy may not apply and how exceptions are handled] ### Questions? Contact [HR/People team] at [contact] for questions about this policy. --- *This policy is subject to change. Material updates will be communicated and a new acknowledgment may be requested. This policy and the handbook in which it appears do not constitute a contract of employment, and employment remains at-will [except as required by Montana law / EU member-state employment law / UK ERA 1996].* ``` ## Acknowledgment receipt template (issue at hire and on material updates) ```markdown EMPLOYEE HANDBOOK ACKNOWLEDGMENT I acknowledge that I have received and read the [Company] Employee Handbook dated [Version Date]. I understand that: 1. This Handbook describes [Company]'s policies and procedur
More from this repository
architectureSkill
|
bump-versionSkill
Use when bumping the Wayland version: update package.json, run checks, branch, commit, push, create PR, wait for merge, tag release.
fix-issuesSkill
|
fix-sentrySkill
|
i18nSkill
|
oss-prSkill
Use when creating a pull request, after committing changes, or when user invokes /oss-pr. Covers branch management, quality checks, commit, push, and PR creation.
pr-automationSkill
|
pr-fixSkill
|