handbook-updates

Diff proposed handbook changes and assess cross-reference and supplement impacts.

Updated May 26, 2026
One-click install
npx skills add https://github.com/yachela/claude-for-legal-ar --skill handbook-updates-yachela
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: handbook-updates
Source: https://github.com/yachela/claude-for-legal-ar/tree/main/employment-legal/skills/handbook-updates
Command: npx skills add https://github.com/yachela/claude-for-legal-ar --skill handbook-updates-yachela

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill prevents inconsistencies by comparing a proposed handbook update against the current handbook and surfacing downstream impacts before publication.

Core Features & Use Cases

  • Change diffing: Produces a clear section-level diff between the proposed language and the current handbook text.
  • Cross-reference impact analysis: Identifies where the changed section is referenced (other policies, defined terms) and flags what may no longer hold.
  • State supplement impact assessment: Checks whether state supplements modify the changed section, flags obsolete or incomplete supplement logic, and highlights when a new supplement may be needed.
  • Promise/risk flagging: Flags potential risk when the update reduces promised benefits, noting that some jurisdictions may require additional notice or consideration.

Quick Start

Ask the handbook-updates skill to update the handbook by diffing your proposed PTO policy language against the current version, then list any cross-reference and state supplement changes required.

Frequently Asked Questions about handbook-updates

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check employee handbook updates for cross-reference and state supplement conflicts?

To check employee handbook updates for conflicts, diff proposed policy language against the current handbook to identify cross-reference breakages and state supplement impacts before publication.

What happens to defined terms and cross-references when I update a PTO policy?

Updating a PTO policy can break defined terms and cross-references when other sections rely on the changed language. A handbook diff validates these connections and flags provisions that no longer hold.

How do I assess state supplement impacts when changing employment policies?

Assess state supplement impacts by checking whether state-specific provisions modify the changed section, flagging obsolete logic, and highlighting when a new supplement is needed for compliance.

Do I need to load configuration files to diff proposed handbook changes?

Yes, you need to load current handbook text and state supplement configuration from CLAUDE.md to generate an accurate diff and produce an actionable publish-readiness checklist.

How do I flag compliance risks when an employee handbook update reduces promised benefits?

Flag compliance risks by checking if the handbook update reduces promised benefits, noting that some jurisdictions may require additional notice or consideration before publishing the policy change.

Can I generate a publish-readiness checklist for employee handbook updates?

Yes, generate a publish-readiness checklist by diffing the proposed handbook changes, validating cross-references, assessing state supplement impacts, and flagging any risk or promise reductions.