No Comments

清理无用注释,保留必要的外部约束与公开合同,并从根因消除注释掩盖的绕路代码。用于用户显式调用 /no-comments 或 $no-comments。

107 stars 21 forksOther

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add Dimon94/skills --skill no-comments
Manual install
git clone --depth 1 https://github.com/Dimon94/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/skills/no-comments ~/.claude/skills/no-comments

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# 注释除草

只在用户显式调用时执行。范围取用户指定的文件或 diff;未指定时取相对 base branch 的当前 diff,默认 `main`,包含暂存与工作区改动。空 diff 则报告无可审查内容。读取邻近代码取证,不扩大写入范围。

## 步骤

1. 读取 [Comment Sicko 审查规则](references/comment-sicko.md)。宿主支持子 agent 时,派一个只读审查者,传入规则、范围和目标项目规范;使用宿主原生接口,不依赖预注册的 `comment-sicko` agent 类型。宿主没有子 agent 时,自己按同一规则审查,并披露缺少独立视角。
2. 复核每项删除、保留和根因修复建议。拒绝越界结论、没有代码坐标的断言和误删例外;审查者修改了文件则拒收。对 `IMPORTANT`、`do not remove`、抑制规则和绕路理由,追到具体符号,必要时调用 how 或 why。证据不足标为 Unknown,保留待查;不能把改短注释当修复。拒收后带原因重审一次;再次拒收则明确失败,不应用该报告。
3. 删除已确认无用的注释。对自身代码的特殊情况,先问:删掉死路径、参数或绕路,改用真实 API、清晰命名、类型或更简单结构,能否让解释不再需要?需要结构变化时先给最小草图,再在授权范围内修复根因。根因在范围外则报告具体坐标与未解决项,不叠加症状守卫。
4. `do not remove`、固定措辞等约束若能由类型、运行时校验、测试或 lint 表达,提出成本最低的编码方案。已有授权覆盖时直接实现;否则等待批准,期间保留尚未编码的有效约束。外部平台怪癖等必要注释继续保留。删除正确性或安全性抑制前,先修复它压住的问题,并运行相应检查;验证不了就保留并报告阻塞。
5. 运行目标项目相关的最小验证,检查 diff 只包含范围内已接受的改动。报告删除数、保留理由、根因修复、恢复项、重审次数、约束编码和 Unknown。无法验证的行为不能宣称已修复。调用本 Skill 不授予提交、推送或发布权限。
Read the full skill on GitHub

Details

Skill name
no-comments
Repository
Dimon94/skills
Path
skills/no-comments/SKILL.md
Repo updated
18 November 2026

FAQ

What does the No Comments skill do?

清理无用注释,保留必要的外部约束与公开合同,并从根因消除注释掩盖的绕路代码。用于用户显式调用 /no-comments 或 $no-comments。

How do I install the No Comments skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add Dimon94/skills --skill no-comments. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is No Comments popular?

It lives in Dimon94/skills, which has 107 GitHub stars and 21 forks.

Related skills

Maintain Verification Skill

107

Dimon94/skills

Periodic pass that keeps a project's verification skill and feature map honest: parallel source readers per feature, one live session driving every feature, at most one PR of proven corrections. Use for /maintain-verification-skill or "audit the verify skill".

Git & Code ReviewIn 2 lists21

Create Verification Skill

107

Dimon94/skills

Generate a project-local verification skill that drives your app the way a user does — any language, framework, or platform. Use for /create-verification-skill, "make a control skill for this repo", or when a project has no scripted way to prove UI/CLI/service behavior.

Software DevelopmentIn 2 lists21

How

107

Dimon94/skills

Use for "how does X work", code walkthroughs before changing something, and placement / ownership / layering questions ("where should this live", "which package owns this", "is this the right layer"). Explains subsystem architecture, runtime flow, onboarding mental models. Use why for motivation.

Software DevelopmentIn 2 lists21

Pi Loop

107

Dimon94/skills

在 pi 里按节奏重复跑同一条提示词或 skill(/loop)。用户要在 pi 中定时轮询、按间隔或 cron 重复任务、让 issue-sweep 这类 skill 自定节奏持续跑,或安装、排查、卸载 pi-loop 扩展时使用。

Other21

Linear Archive Issues

107

Dimon94/skills

归档 Linear Issue。用户要求归档指定 Issue、批量归档已完成或已取消的 Issue,或核实程序化归档能力时使用;通过 GraphQL issueArchive 执行并回读 archivedAt。

Other21

Postmortem

107

Dimon94/skills

Recall or record confirmed reusable failure lessons. Use after a verified recurrence, review escape, failed gate, or explicit user request.

Other21

Browse the most popular Claude skills, all other skills, or write your own with the skills generator.