w95/employee-handbook-builder
TRIGGER THIS when creating or updating employee handbooks, documenting HR policies, developing code of conduct, building benefits guides, or creating leave/PTO policies. Creates comprehensive, legally compliant, accessible employee handbooks covering company policies, culture, benefits, code of conduct, and all required disclosures.
npx skills add https://github.com/w95/awesome-claude-corporate-skills --skill employee-handbook-builder
This skill helps HR professionals and leaders create comprehensive, legally compliant employee handbooks that communicate company policies, culture, benefits, and expectations. It ensures handbooks are clear, inclusive, compliant with federal and state laws, accessible to all employees, and updated regularly to reflect policy changes and legal requirements.
Standard Employee Handbook Sections:
10. Performance & Conduct
11. Workplace Safety & Health
12. Anti-Discrimination, Harassment & Retaliation
13. Data Privacy & Confidentiality
14. Termination & Separation
15. Compliance & Legal
16. Miscellaneous
Clear, Accessible Language:
Format for Readability:
Example (Poor vs. Good):
Poor:
"Employees are expected to maintain professional standards of conduct and comportment in all interactions with colleagues and external stakeholders. Failure to adhere to these standards may result in corrective action, up to and including termination of employment at the sole discretion of the Company."
Good:
"We expect all employees to treat each other with respect and professionalism. This means:
If someone isn't meeting these expectations, we'll address it through feedback and support. Serious or repeated violations may result in discipline, up to and including termination."
Anti-Discrimination & Harassment Policy:
ANTI-DISCRIMINATION & HARASSMENT POLICY
[Company Name] is committed to providing a workplace free from discrimination and harassment based on protected characteristics including race, color, religion, sex, national origin, age, disability, sexual orientation, gender identity, veteran status, or any other characteristic protected by law.
WHAT CONSTITUTES HARASSMENT
Harassment is unwelcome conduct based on a protected characteristic that:
- Creates a hostile, offensive, or intimidating work environment
- Interferes with work performance
- Affects employment decisions or opportunities
Examples include but are not limited to:
- Derogatory comments or slurs based on protected characteristics
- Unwelcome jokes or stereotypes
- Unwanted touching or physical advances
- Exclusion or isolation based on protected characteristics
- Displays of offensive symbols or images
- Unwelcome emails, texts, or social media posts
SEXUAL HARASSMENT SPECIFICALLY
Sexual harassment includes unwelcome sexual advances, requests for sexual favors, or other verbal, written, or physical conduct of a sexual nature when:
- Submission is explicitly or implicitly a condition of employment
- Submission or rejection is used in employment decisions
- It interferes with work or creates an intimidating/hostile environment
This includes quid pro quo harassment (submission required for benefit) and hostile environment harassment (pervasive conduct that's unwelcome).
REPORTING PROCESS
Employees who experience or witness discrimination or harassment should report it immediately to:
- Your direct manager
- HR Department (HR@[company].com)
- Anonymous hotline: [number]
- CEO (if manager is the issue): [email]
You can report verbally or in writing. No retaliation will occur for reporting in good faith.
INVESTIGATION PROCESS
Upon receiving a report:
1. HR will meet confidentially with the person making the report
2. HR will document the complaint
3. HR will notify the person accused of the conduct
4. HR will interview relevant parties and witnesses
5. HR will gather relevant documentation
6. HR will make findings based on evidence
7. HR will notify both parties of outcome
8. Appropriate action will be taken (up to termination)
CONFIDENTIALITY
We will keep complaints as confidential as possible while conducting a thorough investigation. Information will be shared only with those who need to know.
NO RETALIATION
We prohibit any retaliation against employees who report discrimination or harassment in good faith or participate in an investigation. Retaliation includes negative employment actions, ostracism, or any adverse treatment.
CONSEQUENCES
Violation of this policy can result in discipline, up to and including immediate termination. Even first-time violations may result in termination depending on severity.
Remote Work Policy:
REMOTE WORK POLICY
[Company Name] supports remote and flexible work arrangements to promote work-life balance and access to diverse talent.
ELIGIBILITY
Employees may work remotely if:
- Role allows remote work (approved by manager and HR)
- Employee has been employed for 90 days minimum
- Performance is at "meets expectations" or higher
- No open performance issues
Remote work is a privilege, not a right, and can be modified or revoked with notice.
EXPECTATIONS FOR REMOTE WORKERS
Schedule & Availability:
- Core hours: 10am-3pm in [timezone]
- Available for meetings and collaboration during core hours
- Share calendar and vacation time
- Respond to messages within 4 business hours
- Time off requires same approval as office-based employees
Communication:
- Use company communication tools (Slack, email, video)
- Default to written communication for non-urgent items
- Use video for meetings with external stakeholders
- Over-communicate: What you say matters more when face-to-face is limited
- Respect time zones for meetings
Work Environment:
- Maintain a quiet, professional space for calls
- Ensure reliable internet and equipment
- Responsible for securing confidential information (files, conversations)
- Lock computer when away from desk
- Use VPN for work access
Equipment & Expenses:
- Company provides laptop and necessary equipment
- Employee responsible for internet and phone line
- One-time home office stipend: $500 (desk, chair, etc.)
- Reimbursement: Submit receipts within 30 days
In-Person Requirements:
- [Number] days/month in office (if hybrid)
- Attend all mandatory all-hands meetings (virtual or in-person)
- In-person meetings for new hire onboarding
- Optional: Attend team social events and activities
PERFORMANCE EXPECTATIONS
Remote work does not change performance expectations. Managers and employees should:
- Set clear goals and deadlines
- Have regular 1:1 meetings (weekly or bi-weekly)
- Give feedback promptly
- Track progress and outcomes (not hours worked)
- Address performance issues the same way as office-based employees
TEMPORARY REMOTE WORK
In case of emergency (weather, transportation, illness), employees may work remotely with manager approval. These absences should be communicated to manager and noted in time tracking system.
SECURITY & CONFIDENTIALITY
- All work devices use encryption and VPN
- No sharing of login credentials
- Confidential information must be secured
- Screen lock when away from computer
- No work information on personal devices (unless approved)
- Immediately report security concerns
PTO & Vacation Policy:
PAID TIME OFF (PTO) POLICY
[Company Name] provides paid time off to allow employees to rest, recharge, and handle personal needs.
PTO ALLOCATION
Annual PTO: [X days/hours per year]
- Full-time employees: 20 days annually
- Part-time employees: Pro-rated based on hours
- Accrual: [amount per pay period] OR [amount per month]
- Start date: Effective [date hired or date in handbook]
Unused PTO:
- If [state] allows: Unused PTO carries over to next year (max [X] days)
- Upon termination: Unused PTO is paid out (if required by state law)
- No "use it or lose it" policy (where not required by law)
REQUESTING TIME OFF
Process:
- Submit request at least [2 weeks] in advance (or ASAP for unexpected)
- Use [time tracking system] to request
- Manager approval required
- For multiple weeks, discuss with manager regarding timing
Approval Criteria:
- Requests approved based on business needs
- Coverage for critical roles considered
- Fair treatment across team
- First-come, first-served for popular times
- Reasonable requests not denied without cause
TYPES OF TIME OFF
Vacation/Personal Days: Use for rest, travel, personal needs - unscheduled use discouraged
Sick Leave: Use when employee is ill or has medical appointment
- Doctor's note may be required for 3+ consecutive days
- Caring for family member counts as sick leave
- COVID-19 symptoms or positive test: Stay home, paid, notified HR
Bereavement Leave: [X] paid days for death of immediate family
- Immediate family: Spouse, parent, child, sibling
- Extended family: Grandparent, in-laws (at manager discretion)
- Additional unpaid leave available if needed
Personal Days: [X] days per year for personal needs (without details required)
Holidays:
- Company observed holidays: [list]
- Holiday pay: Full day at straight time
- If working on holiday: Discuss with manager (may get comp day)
Jury Duty/Voting:
- Paid time off for jury duty (required by law in most states)
- Paid time off to vote (required by law in most states)
- Court summons should be shared with HR
SCHEDULED TIME OFF
Manager & Employee Responsibilities:
- Cover work during absence
- Brief coverage person on priorities
- Close out or hand off projects
- Set email auto-response with return date and contact person
- Return to office/work on return date ready to go
Team Coverage:
- Do not overload one person with coverage
- Managers ensure adequate staffing during busy times
- Cross-training reduces dependency on single person
PARENTAL LEAVE
[Company Name] supports families with the following parental leave:
Maternity/Paternity Leave: [12 weeks] paid leave
- Applies to birth parent and non-birth parent
- Typically taken immediately after birth
- Job protection during leave (FMLA if applicable)
- Benefits continue during leave
- Some flexibility on when/how to take if desired
Adoption Leave: [12 weeks] paid leave
- Available when adoption becomes final
- Same benefits and protections as birth parental leave
Return to Work:
- Same or equivalent position available
- Phased return available by mutual agreement
- Schedule flexibility available (where possible)
- Communication about return date at least 2 weeks in advance
Additional Support:
- Backup childcare assistance
- Parenting resources and support
- Lactation support and private nursing space
- Employee Assistance Program for parenting support
MILITARY FAMILY LEAVE
Service Member Family Leave: [X days] paid leave
- For family member called to active military duty
- Leave available for certain functions (childcare arrangement, etc.)
- May combine with other leave types
Military Caregiver Leave:
- Unpaid time off to care for family member with military-related injury/illness
- Job protection required by law
Reserve/National Guard Leave:
- Follows state law requirements
- Pay treated as regular compensation
WELLNESS & MENTAL HEALTH LEAVE
Mental Health Days: Part of sick leave (no need to explain)
- Can be used for mental health needs same as physical illness
- Encouraged to take when needed
- No shame or stigma
Employee Assistance Program:
- Free confidential counseling services
- Mental health support and resources
- Work-life balance coaching
- Available to employees and immediate family
SABBATICAL (IF APPLICABLE)
[Company] supports sabbaticals for long-tenured employees:
- Eligibility: [X years] of continuous employment
- Length: [X weeks] every [X years]
- Pay: [Paid/unpaid]
- Request process: Discuss with manager and HR at least [X months] in advance
- Job protection during sabbatical
- Health insurance continues during approved sabbatical
PTO DURING HOLIDAYS
If holiday falls on scheduled PTO day:
- Holiday pay applies (no PTO deducted)
- Example: If Thanksgiving is Wednesday and you have Wed-Fri off, only Thu-Fri deduct from PTO
PAYOUT ON TERMINATION
Upon resignation or termination:
- Unused PTO paid according to state law
- Final paycheck issued on next payroll date
- [State-specific details on timing]
REMOTE WORK & TIME OFF
Remote workers follow same PTO policy as office-based employees.
Federal Requirements to Address:
State-Specific Requirements (vary significantly):
Get Legal Review: Have employment attorney review handbook before distribution, especially if operating in multiple states.
Core Values & Behavior Expectations:
OUR VALUES & HOW WE WORK
[Company Name] is built on [4-5 core values]. We expect all employees to embody these values in their work and interactions.
VALUE 1: [Value Name]
What it means: [Clear definition]
How it shows up:
- [Specific behavior or example]
- [Specific behavior or example]
- [Specific behavior or example]
Real examples:
- [Positive example]
- [Negative example and how to handle differently]
VALUE 2: [Value Name]
[Same structure]
[Continue for each value]
PROFESSIONAL BEHAVIOR EXPECTATIONS
Respect for Others:
- Treat all colleagues with respect regardless of role, background, tenure
- Listen actively without interrupting
- Assume good intent; address concerns directly
- Respect different working styles and perspectives
- No gossip or spreading rumors
Accountability:
- Take responsibility for your work
- Meet commitments and deadlines
- Speak up if you can't deliver
- Own mistakes and learn from them
- Follow through on what you say you'll do
Collaboration:
- Share knowledge and support colleagues
- Ask for help when needed
- Contribute to team success, not just individual wins
- Build relationships across team
- Celebrate others' successes
Continuous Improvement:
- Seek feedback and apply it
- Learn from failures
- Experiment and be willing to try new approaches
- Share learnings with team
- Advocate for process improvements
DRESS CODE STANDARDS
[If applicable: Provide clear expectations]
Example: "We have a business casual dress code. This means:
- Button-up shirts, blouses, or modest sweaters
- Khakis, slacks, dark jeans (no rips or distressing)
- Closed-toe shoes
- Avoid distracting or offensive clothing
- If unsure, check with your manager"
Or: "We have no specific dress code. Dress for your day (in-person meetings, client interaction, video calls, etc.). Use professional judgment and ask if unclear."
WORKING HOURS & ATTENDANCE
Full-time employees: [X hours/week], typically [days and hours]
Part-time employees: [As determined in offer letter]
Core hours: [if applicable, e.g., 10am-3pm]
Punctuality:
- Arrive on time and ready to work
- Notify manager if running late
- Chronic lateness may result in discipline
- Track time accurately
Absence:
- Notify manager as soon as possible if unable to work
- Excessive absences without leave may result in discipline
- Absenteeism patterns will be addressed through performance management
Startup Handbook (20-30 employees):
Growth-Stage Company (30-150 employees):
Established Company (150+ employees):
How to Share Handbook:
Acknowledgment Process:
Keep Records:
Regular Review Schedule:
When to Update:
Communication of Changes:
10. Acknowledgment: Have employees acknowledge receipt
Take w95/employee-handbook-builder from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.