No comments
Spawn a read-only comment reviewer. Act on accepted findings.
Authoring agents defend comments. Defer to a fresh reviewer that did
not write the code.
Companion to comment-mode (granular feedback on prose drafts) and
deslop (broader AI-artifact strip). This skill is the pre-review
comment pass.
Authorized Scope
Apply this engine only within the user's requested task and existing explicit
authorization. Loading or delegating to it grants no additional authority.
Preserve report-only restrictions and the caller's target, host, provider, and
cost limits. Existing approval satisfies a gate only for the same actions and
scope; obtain approval before expanding them. Forward these limits to delegates.
Contract
Inputs:
- The caller's files or diff. Otherwise the current diff against trunk,
including the working tree.
Outputs:
- Deletion count, restored comments, reruns, fixes, encoding offers,
and open work
Creates/Modifies:
- Deletes accepted comments and applies the smallest in-scope
root-cause fixes
External Side Effects:
Confirmation Required:
- Before encoding a constraint comment into a type, test, or lint
- Unattended runs require caller pre-approval for encodings
Delegates To:
how or why when an IMPORTANT or do not remove comment is
thin
architect once, sketch only, when a fix needs a new shape
Steps
- Spawn a read-only review subagent on the fast cheap tier. Pass the
scope and references/comment-review.md.
Do not restate the rules.
- Inspect the report. Reject application-code edits, scope escapes,
exception-protected deletions, and flags that treat kept
intentional code as guilty. A keep survives only with proof it is
about something we cannot change. If a kill is ambiguous, do not
restore. If a keep is refuted or still ambiguous, delete it. Revert
and rerun one rejected report with the failure named. Reject a
second and fail this skill.
- Fix trivial accepted flags directly. If any fix needs a shape, run
architect once for the accepted set and stop at the sketch.
- Implement the smallest root-cause fix in scope. Remove every named
workaround. If the root cause is out of scope, land the smallest
in-scope fix and report the rest open.
- Constraint comments (
do not remove, talk to X before changing)
stay when they are about things we cannot change. Offer the cheapest
in-scope type, runtime, test, or CI lint. Wait for approval. If
approved, encode then delete. Otherwise delete, report the
constraint open, and sketch out-of-scope work.
- Report the deletion count, restored comments, reruns, architect
sketch, fixes, encoding offers, encodings, and open work.
No Comments procedure
Read no-comments procedure when running this workflow.
Apply the authorized scope and mode of this entry point to every step.
Resolve other skills through this distribution’s active catalog; resolve
resources relative to the installed skill directory.
1---
2name: no-comments
3description: Review comments on a diff, delete narration and workaround sermons, fix accepted findings, and offer encodings for claimed constraints. Use before review or when asked to strip comments.
4license: MIT
5metadata:
6 portable_source: "https://github.com/ericlitman/open-pstack"
7 portable_commit: "56bfd14418fa733e34d98f714f357d28788470e3"
8 version: "1.2.0"
9 tags: "comments, review, cleanup"
10 author: Ship Shit Dev
11 source: https://github.com/cursor/plugins/blob/main/pstack/skills/no-comments/SKILL.md
12 upstream_repo: cursor/plugins
13 upstream_ref: main
14 upstream_commit: bdf7aa355337
15 last_synced: "2026-09-05"
16 license: MIT
17when_to_use: "no comments, strip comments, comment review before PR"
18---
19
20# No comments
21
22Spawn a read-only comment reviewer. Act on accepted findings.
23
24Authoring agents defend comments. Defer to a fresh reviewer that did
25not write the code.
26
27Companion to `comment-mode` (granular feedback on prose drafts) and
28`deslop` (broader AI-artifact strip). This skill is the pre-review
29comment pass.
30
31## Authorized Scope
32
33Apply this engine only within the user's requested task and existing explicit
34authorization. Loading or delegating to it grants no additional authority.
35Preserve report-only restrictions and the caller's target, host, provider, and
36cost limits. Existing approval satisfies a gate only for the same actions and
37scope; obtain approval before expanding them. Forward these limits to delegates.
38
39## Contract
40
41Inputs:
42
43- The caller's files or diff. Otherwise the current diff against trunk,
44 including the working tree.
45
46Outputs:
47
48- Deletion count, restored comments, reruns, fixes, encoding offers,
49 and open work
50
51Creates/Modifies:
52
53- Deletes accepted comments and applies the smallest in-scope
54 root-cause fixes
55
56External Side Effects:
57
58- None beyond local edits
59
60Confirmation Required:
61
62- Before encoding a constraint comment into a type, test, or lint
63- Unattended runs require caller pre-approval for encodings
64
65Delegates To:
66
67- `how` or `why` when an `IMPORTANT` or `do not remove` comment is
68 thin
69- `architect` once, sketch only, when a fix needs a new shape
70
71## Steps
72
731. Spawn a read-only review subagent on the fast cheap tier. Pass the
74 scope and [references/comment-review.md](references/comment-review.md).
75 Do not restate the rules.
762. Inspect the report. Reject application-code edits, scope escapes,
77 exception-protected deletions, and flags that treat kept
78 intentional code as guilty. A keep survives only with proof it is
79 about something we cannot change. If a kill is ambiguous, do not
80 restore. If a keep is refuted or still ambiguous, delete it. Revert
81 and rerun one rejected report with the failure named. Reject a
82 second and fail this skill.
833. Fix trivial accepted flags directly. If any fix needs a shape, run
84 `architect` once for the accepted set and stop at the sketch.
854. Implement the smallest root-cause fix in scope. Remove every named
86 workaround. If the root cause is out of scope, land the smallest
87 in-scope fix and report the rest open.
885. Constraint comments (`do not remove`, `talk to X before changing`)
89 stay when they are about things we cannot change. Offer the cheapest
90 in-scope type, runtime, test, or CI lint. Wait for approval. If
91 approved, encode then delete. Otherwise delete, report the
92 constraint open, and sketch out-of-scope work.
936. Report the deletion count, restored comments, reruns, architect
94 sketch, fixes, encoding offers, encodings, and open work.
95
96## No Comments procedure
97
98Read [no-comments procedure](references/no-comments-procedure.md) when running this workflow.
99Apply the authorized scope and mode of this entry point to every step.
100Resolve other skills through this distribution’s active catalog; resolve
101resources relative to the installed skill directory.