gap-surfacer

Tracks open regulatory policy gaps in a YAML tracker and notifies owners via Slack.

Updated Jun 17, 2026
One-click install
npx skills add https://github.com/tk1cntt/PhapChe --skill gap-surfacer-tk1cntt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gap-surfacer
Source: https://github.com/tk1cntt/PhapChe/tree/main/docs/claude-for-legal-main/regulatory-legal/skills/gap-surfacer
Command: npx skills add https://github.com/tk1cntt/PhapChe --skill gap-surfacer-tk1cntt

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Regulatory gaps get found during policy reviews and then forgotten. This Skill keeps a persistent tracker of open compliance gaps, surfaces what is overdue or aging, routes items to owners, and sends Slack notifications so nothing slips past its deadline. ## Core Features & Use Cases - Gap ingestion and tracking: Appends gaps found by policy-diff into a YAML tracker with de-duplication, gap-type classification (partial, full, new-policy, watch, comment-decision), and owner assignment. - Status reporting: Produces a prioritized report with overdue, due-soon, open, watch, and recently-closed buckets, plus oldest-gap age and per-owner breakdowns. - Owner notification with confirmation gates: Sends Slack DMs for assignments and due-date reminders only after previewing the message and receiving explicit user confirmation. - Use Case: After a policy-diff run flags that a new state privacy rule is not covered by your privacy policy, the gap is logged with an owner and due date, the owner receives a Slack assignment notice, and the gap appears in every status report until it is closed or risk-accepted. ## Quick Start Ask the assistant to show the current open compliance gaps and which ones are overdue or due within 30 days.

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 after a policy review?

Gaps found by policy-diff are appended to a gap-tracker.yaml file with an ID, requirement, regulation citation, owner, due date, and status. The tracker persists until each gap is closed with a resolution note or risk-accepted with documented rationale.

How do I notify gap owners in Slack about new compliance gaps?

When Slack MCP is configured and the gap has an owner_slack value, the skill previews the assignment DM and waits for explicit confirmation before sending. If Slack is unavailable, the missed notification is flagged in the status report for manual follow-up.

What is the difference between a watch item and a compliance gap?

Watch and comment-decision entries track pre-rulemaking items like ANPRs and NPRMs with no current compliance obligation. They appear in a separate report bucket so overdue and due-soon bands contain only binding compliance deadlines.

Can a gap be closed automatically once the policy is updated?

No. Closing a gap requires an explicit resolution note describing the human action taken, and non-lawyer users must pass a consequential-action gate confirming attorney review before any gap is closed or compliance is certified.

Why is a gap not showing as overdue even though its due date passed?

Gaps with status_verified set to false are never classified as overdue because the underlying rule may not be in force. They are routed to the watch bucket with a note to verify the rule's status before escalating.