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.