One-click install
npx skills add https://github.com/PolliticalSolutions/political-portal --skill handbook-updates-polliticalsolutions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: handbook-updates
Source: https://github.com/PolliticalSolutions/political-portal/tree/main/.claude/skills/employment-legal/handbook-updates
Command: npx skills add https://github.com/PolliticalSolutions/political-portal --skill handbook-updates-polliticalsolutions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Handbook edits can silently break cross-references, state supplement overrides, and promises about benefits, creating inconsistencies that are hard to catch before publishing.

Core Features & Use Cases

  • Change diffing: Compares proposed handbook language against the current section and presents a clear before/after diff.
  • Cross-reference impact analysis: Locates other policies that cite the changed section and checks whether references still make sense.
  • State supplement risk review: Evaluates whether each state supplement modifies the changed section and flags obsolete, incomplete, or missing supplement updates.
  • Promise check: Detects potential benefit reductions that could raise contractual or notice/consideration risks in some jurisdictions.

Quick Start

Use the handbook-updates skill when you have a proposed handbook change and want a diff plus cross-reference and state supplement impact analysis before publishing.

Frequently Asked Questions about handbook-updates

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

FAQPage Schema
How do I check handbook updates for cross-reference breaks before publishing?

Handbook updates risk breaking state supplement overrides when section language changes. The skill evaluates whether each state supplement modifies the changed section, then flags obsolete, incomplete, or missing supplement updates to prevent inconsistencies.

How does a benefit promise check work for employment handbook policy changes?

To analyze PTO and leave cross-references, provide the proposed handbook change and current section text. The skill generates a structured diff and impact table, checking whether related policy references still align before producing a readiness checklist.

Can I use this for state supplement risk review on employment-legal handbooks?

Handbook edits can silently break cross-references, state supplement overrides, and benefit promises. The skill catches these inconsistencies by diffing new text against current versions and analyzing downstream impacts before publishing.

What is the best way to diff handbook changes and identify downstream ripple effects?

Yes, this handles PTO and leave policy cross-references by locating other policies that cite the changed section. It checks whether those references still make sense after the update and flags any broken connections in the impact table.