plugins/hr-people-ops/skills/policies/policy-document-writer/SKILL.md
Create clear, compliant HR policies and employee handbook content. Use this skill when writing company policies, updating handbooks, or ensuring compliance. Activate when: HR policy, company policy, employee handbook, workplace policy, PTO policy, remote work policy.
npx skillsauth add latestaiagents/agent-skills policy-document-writerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Create clear, legally compliant HR policies and handbook content.
# [Policy Name]
**Effective Date:** [Date]
**Last Updated:** [Date]
**Policy Owner:** [Department/Role]
**Applies To:** [All employees / Specific groups]
## Purpose
[Why this policy exists - 1-2 sentences]
## Scope
[Who this policy applies to and when]
## Policy Statement
[The actual policy rules and guidelines]
## Procedures
[Step-by-step processes for implementing the policy]
## Responsibilities
[Who is responsible for what]
## Definitions
[Key terms defined]
## Related Policies
[Links to related policies]
## Questions
[Contact information for questions]
---
*This policy is subject to change. Employees will be notified of updates.*
# Remote Work Policy
**Effective Date:** [Date]
**Applies To:** All eligible employees
## Purpose
This policy establishes guidelines for remote work arrangements to support flexibility while maintaining productivity and collaboration.
## Eligibility
Remote work may be available to employees who:
- Have completed their probationary period
- Demonstrate ability to work independently
- Have job responsibilities compatible with remote work
- Have reliable internet and appropriate workspace
## Types of Remote Work
1. **Fully Remote:** Work from home 100% of the time
2. **Hybrid:** Split time between office and remote (e.g., 3 days office, 2 days remote)
3. **Occasional Remote:** As-needed flexibility with manager approval
## Expectations
### Work Hours
- Core hours: [e.g., 10 AM - 3 PM local time] for meetings and collaboration
- Flexible hours outside core hours to complete full workday
- Response time: Within [X hours] during work hours
### Communication
- Keep calendar updated with availability
- Be reachable via Slack/Teams during work hours
- Camera-on for team meetings unless otherwise agreed
- Attend required in-person meetings/events
### Workspace Requirements
- Dedicated workspace with minimal distractions
- Reliable high-speed internet
- Secure, private environment for confidential work
### Equipment
- Company will provide: [laptop, monitor, etc.]
- Employee responsible for: [internet, furniture, etc.]
- Reimbursement available for: [specify items and limits]
## Security
- Use company VPN for all work
- Lock computer when stepping away
- Do not work from public WiFi without VPN
- Report any security concerns immediately
## Performance
- Performance expectations remain the same as in-office
- Regular check-ins with manager
- Participation in team meetings and activities
## Approval Process
1. Discuss with direct manager
2. Complete remote work agreement form
3. HR review and approval
4. Annual renewal required
## Termination of Remote Work
The company may modify or revoke remote work arrangements based on:
- Business needs
- Performance concerns
- Policy violations
# Paid Time Off Policy
**Effective Date:** [Date]
**Applies To:** All full-time employees
## PTO Allowance
| Tenure | Annual PTO |
|--------|-----------|
| 0-2 years | 15 days |
| 3-5 years | 20 days |
| 6+ years | 25 days |
## Accrual
- PTO accrues [bi-weekly/monthly] based on annual allowance
- Maximum accrual cap: [X] days
- Accrued PTO carries over up to [X] days annually
## Requesting Time Off
1. Submit request in [HR system] at least [X] days in advance
2. Manager approval required
3. Blackout periods may apply during [critical business periods]
## Holidays
The following paid holidays are observed:
- New Year's Day
- [List other company holidays]
- [Floating holidays if applicable]
## Sick Leave
- [X] days sick leave per year
- No advance notice required for illness
- Doctor's note required for absences over [X] consecutive days
## Unpaid Leave
Available for circumstances beyond PTO allowance, subject to manager and HR approval.
## PTO at Termination
- Accrued, unused PTO paid out upon termination
- PTO cannot be used during notice period without approval
# Code of Conduct
**Effective Date:** [Date]
**Applies To:** All employees, contractors, and representatives
## Our Commitment
[Company] is committed to maintaining a respectful, inclusive, and ethical workplace.
## Expected Behaviors
### Respect & Inclusion
- Treat all individuals with dignity and respect
- Value diverse perspectives and backgrounds
- Create an environment where everyone can contribute
- Address concerns through appropriate channels
### Professional Conduct
- Maintain professional relationships with colleagues, clients, and partners
- Represent the company positively
- Protect confidential information
- Avoid conflicts of interest
### Communication
- Communicate openly and honestly
- Give and receive feedback constructively
- Escalate concerns appropriately
- Maintain confidentiality when required
## Prohibited Behaviors
### Harassment & Discrimination
Zero tolerance for harassment or discrimination based on:
- Race, color, national origin
- Gender, gender identity, sexual orientation
- Age, disability, religion
- Any other protected characteristic
### Workplace Violence
- Physical violence or threats
- Intimidation or bullying
- Possession of weapons on company property
### Dishonesty
- Falsifying records or reports
- Theft or misuse of company resources
- Fraud or misrepresentation
## Reporting Concerns
- Direct manager
- HR department: [contact]
- Anonymous hotline: [if available]
- All reports investigated confidentially
## Consequences
Violations may result in disciplinary action up to and including termination.
# Anti-Harassment Policy
**Effective Date:** [Date]
**Applies To:** All employees, contractors, vendors, and visitors
## Policy Statement
[Company] prohibits all forms of harassment and is committed to maintaining a workplace free from intimidation, hostility, and offensive behavior.
## Definition of Harassment
Harassment includes unwelcome conduct based on protected characteristics that:
- Creates an intimidating, hostile, or offensive work environment
- Unreasonably interferes with work performance
- Affects employment decisions
### Examples Include:
- Offensive jokes, slurs, or name-calling
- Physical assaults or threats
- Intimidation, ridicule, or mockery
- Offensive objects, pictures, or materials
- Interference with work performance
### Sexual Harassment
Unwelcome sexual advances, requests for sexual favors, or other verbal/physical conduct of a sexual nature, including:
- Quid pro quo: Employment decisions based on submission to advances
- Hostile environment: Conduct that creates an offensive workplace
## Reporting Procedures
### How to Report
1. **Informal Resolution:** Speak directly with the person (if comfortable)
2. **Formal Report:** Contact HR, your manager, or use anonymous hotline
3. **Written Complaint:** Submit detailed written account
### What to Include
- Description of incident(s)
- Names of individuals involved
- Dates, times, locations
- Names of witnesses
- Any documentation
## Investigation Process
1. All complaints taken seriously and investigated promptly
2. Confidentiality maintained to extent possible
3. Both parties interviewed
4. Witnesses interviewed
5. Findings documented
6. Appropriate action taken
7. Follow-up with complainant
## Non-Retaliation
Retaliation against anyone who reports harassment or participates in an investigation is strictly prohibited and will result in disciplinary action.
## Resources
- HR Department: [contact]
- Employee Assistance Program: [contact]
- EEOC: www.eeoc.gov
- [ ] Legal review completed
- [ ] Leadership approval obtained
- [ ] Communication plan created
- [ ] All-hands or team meetings scheduled
- [ ] Written communication prepared
- [ ] FAQ document created
- [ ] Manager talking points prepared
- [ ] Acknowledgment tracking set up
- [ ] Feedback mechanism established
Subject: [New/Updated] Policy: [Policy Name]
Team,
We are [introducing/updating] our [Policy Name] policy, effective [Date].
**What's Changing:**
- [Key change 1]
- [Key change 2]
- [Key change 3]
**Why This Matters:**
[Brief explanation of the reason for the policy/change]
**What You Need to Do:**
1. Review the full policy [link]
2. Acknowledge receipt by [date]
3. Direct questions to [contact]
**Resources:**
- Full policy: [link]
- FAQ: [link]
- Questions: [contact]
Thank you for your attention to this important update.
[HR Team]
development
Test skills for correct activation, content quality, and regression — both automated checks (frontmatter validity, lint) and manual verification (query-suite activation testing). Covers CI integration and how to catch skill regressions before users do. Use this skill when adding skills to a repo, setting up CI for a skill library, or debugging "the skill exists but doesn't work". Activate when: test skills, validate skills, skill CI, skill linting, skill activation test, skill regression.
documentation
Write the YAML frontmatter for a SKILL.md file so it activates reliably — name, description, and activation keywords that the model matches against. Covers length, tone, and the most common frontmatter mistakes. Use this skill when authoring a new skill, fixing a skill that isn't auto-activating, or reviewing skills for publication. Activate when: SKILL.md frontmatter, skill description, skill activation, skill YAML, write a skill, author a skill.
development
Design skills that fire at the right moment — neither over-eager (noise) nor under-eager (silent). Covers activation specificity, trigger phrases, disambiguation between overlapping skills, and debugging activation. Use this skill when multiple skills could fire on the same query, a skill never fires, or a skill fires too often. Activate when: skill won't activate, skill over-activates, overlapping skills, skill triggers, skill selection, skill disambiguation.
development
Structure SKILL.md content so the model reads just enough — concise summary up front, progressively deeper detail, examples on demand. Covers section ordering, length budgets, when to split into multiple skills. Use this skill when writing or refactoring a skill body, one skill has grown too long, or a skill is wordy but not useful. Activate when: SKILL.md structure, skill content, skill too long, split skill, progressive disclosure, skill body.