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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Gap Surfacer prevents policy gaps from being forgotten by maintaining a live tracker of regulatory gaps, aging items, and pre-rule watch items, and by prompting the right owners to remediate them in time.

Core Features & Use Cases

  • Gap tracking with structured statuses: Ingests policy-diff findings into a persistent gap tracker (open, in-progress, closed, risk-accepted) and keeps unverified items from being misclassified as binding overdue deadlines.
  • Owner notification with a strict safety gate: Sends Slack assignment and reminder messages only after per-send preview and explicit user confirmation, including an added warning when citations or deadlines might be unverified.
  • Role-aligned operational outputs: Produces a status report that separates real compliance gaps (🔴/🟠/🟡/🟡) from forward-looking watch items (including comment-decision items) so teams can triage correctly.
  • Matter- and practice-context awareness: Loads the active matter’s context when enabled and writes outputs to the correct matter folder, avoiding cross-matter contamination.

Quick Start

Use the gap-surfacer skill to ingest newly discovered compliance gaps and generate an owner-ready status report for the current regulatory-legal workstream.

Frequently Asked Questions about gap-surfacer

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

FAQPage Schema
How do I track regulatory compliance gaps from policy diffs?

Track regulatory compliance gaps by ingesting policy-diff findings into a persistent gap tracker that separates verified overdue items from unverified watch items. The tracker maintains statuses like open, in-progress, closed, and risk-accepted to prevent discovered gaps from being forgotten.

Can I send Slack notifications to assign compliance gaps to owners?

Yes, you can send Slack assignment and reminder messages to compliance gap owners. Notifications require per-send preview and explicit user confirmation before delivery, and automatically append warnings when citations or deadlines might be unverified.

How do I generate a compliance status report that separates overdue items from watch items?

Generate a compliance status report that separates real binding gaps from forward-looking watch items using color-coded severity levels. This allows teams to triage verified overdue deadlines separately from unverified comment-decision items.

Does gap tracking support matter context for regulated-policy workflows?

Yes, gap tracking supports matter and practice context awareness. It loads the active matter’s context when enabled and writes outputs to the correct matter folder, preventing cross-matter contamination in regulated-policy workflows.

Why do compliance-certifying outputs require role checks?

Compliance-certifying outputs require role checks to gate sensitive status reports and ensure only authorized personnel can certify compliance. This safety mechanism prevents unauthorized users from approving regulatory remediation actions.

What is the best way to manage unverified deadlines in a regulatory gap tracker?

Manage unverified deadlines by separating them from binding overdue items in the gap tracker. The system flags unverified citations and deadlines with explicit warnings, keeping them classified as watch items rather than misclassifying them as confirmed overdue actions.