Agent skill

Gap Surfacer

by zhou210712 in zhou210712/claude-for-legal-ZH

参考资料:支持 /regulatory-legal:gaps 和 /regulatory-legal:comments 的共享差距和意见征集跟踪框架。跟踪未关闭的政策差距及其整改状态, 从 policy-diff 中获取差距,呈现开放和即将到期的事项,路由给负责人, 并通过企业通讯工具通知差距负责人,每次发送前需确认。

Apache-2.0Auto-check passed

Install Gap Surfacer

skills CLI
$ npx skills add zhou210712/claude-for-legal-ZH --skill gap-surfacer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install zhou210712/claude-for-legal-ZH gap-surfacer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/zhou210712/claude-for-legal-ZH.git skills-src && mkdir -p .claude/skills && cp -r skills-src/regulatory-legal/skills/gap-surfacer .claude/skills/gap-surfacer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
gap-surfacer
GitHub stars
225
Token cost
~757 tokens
SKILL.md length
78 words
Files
3 (incl. references)
Skills in repo
122
Repo updated
First seen
Licence
Apache-2.0

At a glance

参考资料:支持 /regulatory-legal:gaps 和 /regulatory-legal:comments 的共享差距和意见征集跟踪框架。跟踪未关闭的政策差距及其整改状态, 从 policy-diff 中获取差距,呈现开放和即将到期的事项,路由给负责人, 并通过企业通讯工具通知差距负责人,每次发送前需确认。

  • Works in 3 steps: 向用户展示你即将发送给谁、发送什么内容。 → 等待明确的同意。 → 绝不要不经确认就发送。不因是定时任务而跳过。不因是批量而跳过。不因昨天发送过而跳过。
  • SKILL.md covers 逐次发送确认——无例外, 目的, 跟踪文件 and 模式, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Gap Surfacer is an agent skill from zhou210712/claude-for-legal-ZH. 参考资料:支持 /regulatory-legal:gaps 和 /regulatory-legal:comments 的共享差距和意见征集跟踪框架。跟踪未关闭的政策差距及其整改状态, 从 policy-diff 中获取差距,呈现开放和即将到期的事项,路由给负责人, 并通过企业通讯工具通知差距负责人,每次发送前需确认。 由 gaps 和 comments 技能在实质工作前加载。

Its SKILL.md is about 760 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/comment-tracker.yaml` and `references/gap-tracker.yaml`).

The licence is Apache-2.0.

Example prompts

  • “/gap-surfacer”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. 向用户展示你即将发送给谁、发送什么内容。
  2. 等待明确的同意。
  3. 绝不要不经确认就发送。不因是定时任务而跳过。不因是批量而跳过。不因昨天发送过而跳过。

What it can do on your machine

Read from SKILL.md and the folder at commit 2f01c92. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are yaml and markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Gap Surfacer loads about 757 tokens when it runs, and up to ~1k if it reads all its reference files. Until then it costs about 51 tokens; SKILL.md has 78 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~51
When it runs · the whole SKILL.md, loaded when a task matches
~757
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from zhou210712/claude-for-legal-ZH at commit 2f01c92, republished under its Apache-2.0 licence (© zhou210712). 78 words, ~757 tokens.

Download SKILL.mdSave it as .claude/skills/gap-surfacer/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
gap-surfacer
description
参考资料:支持 /regulatory-legal:gaps 和 /regulatory-legal:comments 的共享差距和意见征集跟踪框架。跟踪未关闭的政策差距及其整改状态, 从 policy-diff 中获取差距,呈现开放和即将到期的事项,路由给负责人, 并通过企业通讯工具通知差距负责人,每次发送前需确认。 由 gaps 和 comments 技能在实质工作前加载。
user-invocable
false

差距呈现

负责人通知:默认开启。如需选择某个负责人不接收通知,将 owner_contact 留空。

逐次发送确认——无例外

在发送任何通知消息(分配通知、逾期提醒、批量通知、状态报告)之前:

  1. 向用户展示你即将发送给谁、发送什么内容。
  2. 等待明确的同意。
  3. 绝不要不经确认就发送。不因是定时任务而跳过。不因是批量而跳过。不因昨天发送过而跳过。

未经确认的自动发送是本插件中最不可逆的操作——发送了插件自身页脚声明可能出错的内容,给无法检查的人。这种组合不能跳过审阅。


目的

差距被发现后就忘了。此技能跟踪它们直到关闭,并通知负责关闭它们的人。

跟踪文件

位于 ~/.claude/plugins/config/claude-for-legal/regulatory-legal/gap-tracker.yaml:

yaml
gaps:
  - id: GAP-001
    requirement: "[法规要求的内容]"
    regulation: "[名称 + 引用]"
    policy_affected: "[名称或'需要制定新政策']"
    gap_type: "partial"  # none | partial | full | new-policy | watch | comment-decision
    owner: "[政策索引中的姓名]"
    owner_contact: "[联系方式,如已知]"
    opened: 2026-03-01
    due: 2026-06-01  # 法规生效日期、内部截止日期或意见征集截止日期
    status_verified: true  # 如果上游政策差异分析无法确认法规有效,则为false;未验证的事项永不会进入🔴逾期分类
    status: "open"  # open | in-progress | closed | risk-accepted
    notified: false  # 分配通知发送后设为true
    resolution: ""  # 关闭时填写

绝不要将差距分类为"逾期"——如果法规未经验证。 🔴逾期分类意味着"我们错过了一个具有约束力的截止日期"。如果法规状态未经验证(政策差异分析设置了 status_verified: false,或法规>12个月/已超过适用日期且未确认时效性),截止日期可能不具有约束力。使用🟡"需要审查"并注明。

gap_type 语义:

值含义典型提醒频率
none政策已涵盖此要求。仅为审计追踪记录。无自动提醒。
partial政策涵盖该主题但未完全覆盖新要求。需要修订。到期前30天。
full政策与新要求矛盾或未提及。需要重写或添加新章节。到期前30天。
new-policy现有政策中无此项内容。需要起草政策。到期前30天。
watch前瞻性事项——预征求意见、调研通知、尚未最终确定的征求意见稿。当前没有合规义务;政策工作等待正式法规出台。due: 是重访日期,不是合规截止日期。无自动提醒;在征求意见稿发布时或重访日期重新评估。
comment-decision预规则意见征集决策待定——团队正在决定是否提交反馈意见。due: 是意见征集截止日期。截止日期前21天(比合规差距更紧凑)。

模式

模式1:从政策差异分析中获取

当政策差异分析发现差距时,追加到 gap-tracker.yaml。去重——相同要求 + 相同政策 = 相同差距,不重复计算。

获取后,通知负责人:

如果企业通讯工具可用且 owner_contact 已设置:向差距负责人发送通知——但仅在完成逐次发送确认之后。预览消息给用户,等待明确的同意,然后发送。发送后将 notified: true 设置在跟踪条目中。

模式2:状态报告
markdown
[工作成果头 — 按照插件配置 ## 输出]

## 开放差距 — [日期]

### 要点

[N个差距需要在[日期]前采取行动 — 前3项:X、Y、Z]

### 🔴 逾期

| ID | 要求 | 政策 | 负责人 | 截止日期 | 逾期天数 |
|----|------|------|--------|----------|---------|
| | | | | | |

### 🟠 30天内到期

[同上]

### 🟡 开放

[同上]

### 👀 观察事项(前瞻性——预法规)

[预法规跟踪——`watch` 和 `comment-decision` 条目。这些不是合规差距。单独呈现。]

### 进行中

[同上]

### 最近关闭

[最近5项,附解决方案]

---

**最早开放的差距:** [ID],[N]天
**按负责人分组的差距:** [分布]
**负责人通知已发送:** [N] / [N个总差距]

---

**依赖前核实引注。** 此跟踪文件中的法规引注由AI在上游生成(reg-feed-watcher 和 policy-diff),未经对照一手来源核实。在关闭、接受风险或引用到任何合规声明、董事会报告或监管机构回复之前,通过法律研究工具确认。
模式3:关闭差距

更新状态为 closed,记录解决方案和关闭日期。

模式4:风险接受

有时答案是"我们不打算修复这个"。这是一个有效的决定——但应被记录。

状态 → risk-accepted。保留在跟踪文件中(不删除),但不出现在开放差距报告中。

收尾

以 CLAUDE.md ## 输出 规定的下一步决策树收尾。

如果跟踪器呈现超过约10个开放差距,或用户任何时候提出要求:提供仪表板——按严重程度统计、按截止日期排列的差距时间线、及附有负责人、状态和最后更新日期的可排序网格。


本技能不做的事

  • 不自行关闭差距。关闭需要解决方案说明和该说明所描述的人工操作。
  • 如果企业通讯工具未配置,不发送通知。回退到在状态报告中标记。
  • 不对每个差距在7天内发送超过一次提醒。提醒一次,不反复催促。

© zhou210712, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in regulatory-legal/skills/gap-surfacer of zhou210712/claude-for-legal-ZH.

  • SKILL.md
  • references/comment-tracker.yaml
  • references/gap-tracker.yaml

Open the folder on GitHubat commit 2f01c92

Compare with similar skills

Gap Surfacer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Gap Surfacer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gap Surfacer this skillzhou210712/claude-for-legal-ZH225—~757Automated safety check: PassApache-2.0
Gap Surfaceranthropics/claude-for-legal9.6k1 repos~3.7kAutomated safety check: PassApache-2.0
No Commentscursor/plugins11k7 repos~640Automated safety check: PassNone
Commentsanthropics/claude-for-legal9.6k1 repos~1kAutomated safety check: PassApache-2.0
Gapsanthropics/claude-for-legal9.6k2 repos~229Automated safety check: PassApache-2.0
Regulatory Affairs Headdavila7/claude-code-templates33k1 repos~1.3kAutomated safety check: PassMIT

Similar skills

  • Gap Surfacer

    anthropics/claude-for-legal

    Official

    Reference: shared gap- and comment-tracker framework backing /regulatory-legal:gaps and /regulatory-legal:comments.

    9.6k GitHub starsUsed in 1 repo~3.7k tokens
    Auto-check passed
  • No Comments

    cursor/plugins

    Official

    Spawn Comment Sicko, fix accepted findings, and offer encodings for claimed constraints.

    11k GitHub starsUsed in 7 repos~640 tokens
    Auto-check passed
  • Comments

    anthropics/claude-for-legal

    Official

    Review open NPRM comment periods, log decisions, track deadlines.

    9.6k GitHub starsUsed in 1 repo~1k tokens
    Auto-check passed
  • Gaps

    anthropics/claude-for-legal

    Official

    Open gaps tracker — what's flagged and not yet closed. An agent skill from anthropics/claude-for-legal.

    9.6k GitHub starsUsed in 2 repos~229 tokens
    Auto-check passed
  • Regulatory Affairs Head

    davila7/claude-code-templates

    Senior Regulatory Affairs Manager expertise for HealthTech and MedTech companies.

    33k GitHub starsUsed in 1 repo~1.3k tokens
    Legal & ComplianceAuto-check passed
  • Regulatory Affairs Head

    alirezarezvani/claude-skills

    Senior Regulatory Affairs Manager for HealthTech and MedTech companies.

    28k GitHub starsUsed in 1 repo~4.9k tokens
    Legal & ComplianceAuto-check passed

More from zhou210712/claude-for-legal-ZH

All 122 skills in this repo
  • Claim Chart

    zhou210712/claude-for-legal-ZH

    构建或审查要件分析表——专利权利要求对照表(侵权、无效或审查)或 民事构成要件分析表(任何诉讼请求或抗辩),每个单元格附精确引用, 缺口检测为优先输出。当用户要求要件分析表、权利要求对照表、 证据对照表、侵权或无效主张、逐要件映射,或问"我们证明[主张]还缺什么"时使用。

    225 GitHub stars~1.3k tokensUpdated 4 mo ago
    Auto-check passed
  • Client Intake

    zhou210712/claude-for-legal-ZH

    结构化接待——实践领域模板、跨领域考点识别、利益冲突标记、分流分类. An agent skill from zhou210712/claude-for-legal-ZH.

    225 GitHub stars~1.2k tokensUpdated 4 mo ago
    Auto-check passed
  • Launch Review

    zhou210712/claude-for-legal-ZH

    对照您的框架和风险校准进行全面产品上线审查。当用户说"审查这个上线" "[功能]法务审查""我们能上线吗""[产品]有什么法律问题"或引用了需要 逐类审查备忘录的产品需求文档或上线追踪工单时使用。

    225 GitHub stars~2k tokensUpdated 4 mo ago
    Auto-check passed
  • Reg Feed Watcher

    zhou210712/claude-for-legal-ZH

    检查法规动态源,报告自上次检查以来的新事项,按重要度阈值过滤。适用于用户说"检查法规动态"、"有什么新规定"、"法规更新"、从定时任务触发执行,或手动粘贴法规动态进行分类和差异分析时。

    225 GitHub stars~1.2k tokensUpdated 4 mo ago
    Auto-check passed
  • Renewal Tracker

    zhou210712/claude-for-legal-ZH

    展示具有即将到来的取消截止日期的合同,在通知窗口关闭前发出预警, 基于维护的续约登记册运行。当用户询问"什么即将续约""哪些续约即将到期" "我们是否错过了取消窗口""将此添加到续约追踪器"时使用,或按计划运行。

    225 GitHub stars~681 tokensUpdated 4 mo ago
    Auto-check passed
  • Skill Installer

    zhou210712/claude-for-legal-ZH

    从已监视注册表安装社区技能。先读白名单,获取,展示原始 SKILL.md (而非仅摘要),运行结构性信任检查,运行 skills-qa,仅在用户明确 批准后才写入文件。当用户说"安装[技能]"、在浏览中选择安装、或提供 直接技能 URL 时使用。

    225 GitHub stars~3k tokensUpdated 4 mo ago
    Auto-check passed

Questions about Gap Surfacer

What does Gap Surfacer do?

参考资料:支持 /regulatory-legal:gaps 和 /regulatory-legal:comments 的共享差距和意见征集跟踪框架。跟踪未关闭的政策差距及其整改状态, 从 policy-diff 中获取差距,呈现开放和即将到期的事项,路由给负责人, 并通过企业通讯工具通知差距负责人,每次发送前需确认。. Gap Surfacer is an agent skill from zhou210712/claude-for-legal-ZH.

How do I install Gap Surfacer in Claude Code?

Run `npx skills add zhou210712/claude-for-legal-ZH --skill gap-surfacer -a claude-code`. Or copy the skill folder (regulatory-legal/skills/gap-surfacer in zhou210712/claude-for-legal-ZH) into .claude/skills/gap-surfacer in your project. Claude Code loads it when a task matches its description.

How do I install Gap Surfacer in Codex?

Run `npx skills add zhou210712/claude-for-legal-ZH --skill gap-surfacer -a codex`. Or copy the skill folder (regulatory-legal/skills/gap-surfacer in zhou210712/claude-for-legal-ZH) into .agents/skills/gap-surfacer in your project. Codex loads it when a task matches its description.

Can I use Gap Surfacer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add zhou210712/claude-for-legal-ZH --skill gap-surfacer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gap-surfacer, .gemini/skills/gap-surfacer, .github/skills/gap-surfacer and .opencode/skills/gap-surfacer in your project.

What does Gap Surfacer need to run?

SKILL.md names no scripts, command-line tools or credentials: Gap Surfacer is instructions for the agent only.

Does Gap Surfacer access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Gap Surfacer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Gap Surfacer use?

Gap Surfacer is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Gap Surfacer use?

About 757 tokens (SKILL.md is roughly 3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 290 tokens, read only when the agent opens those files.

What are the alternatives to Gap Surfacer?

Skills that share tags, products or a category with Gap Surfacer: Gap Surfacer (anthropics/claude-for-legal, 9.6k stars), No Comments (cursor/plugins, 11k stars), Comments (anthropics/claude-for-legal, 9.6k stars) and Gaps (anthropics/claude-for-legal, 9.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gap Surfacer?

zhou210712 (a GitHub user) maintains it in zhou210712/claude-for-legal-ZH, which has 225 GitHub stars. The repository holds 122 skills in this directory. The repository was last updated on May 15, 2026.

Source: zhou210712/claude-for-legal-ZH on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.