Rewrites code comments and doc blocks to be short and reason-focused.
npx skills add https://github.com/lxsmnsyc/overwander --skill light-comments-lxsmnsyc
Please help me install this Agent Skill. Skill: light-comments Source: https://github.com/lxsmnsyc/overwander/tree/main/.agents/skills/light-comments Command: npx skills add https://github.com/lxsmnsyc/overwander --skill light-comments-lxsmnsyc
/** */ blocks on exported functions, types, and constants that state what the thing is and the one thing a caller could get wrong. - Preservation rules: Keeps lint directives, external links, formulas, and warnings that prevent bugs or data loss verbatim. - Use Case: While reviewing a TypeScript pull request, apply this Skill to condense a ten-line doc block into three lines that state the query reason, the consumer, and the caveat. ## Quick Start Review the comments in this file and rewrite any that restate the code or narrate history into short why-focused notes.High-intent search queries and answers about installing and using this skill.
Write comments that state the non-obvious reason, constraint, or trap rather than restating what the code does. Keep most blocks to one to four lines, cut history and build-up, and delete comments on code that is already plainly readable.
Most doc blocks should be one to four lines. A block over roughly eight lines needs a real reason to exist, such as a formula, a protocol, a subtle invariant, or a module header.
It should answer what the thing is and the one thing a caller could get wrong, not how it works inside. Interface fields get one line each unless the field carries a rule like a default or a stored-empty convention.
Delete an inline comment when the code is plainly readable and the comment only restates the line. Keep an inline comment only when it explains a line that looks wrong but is actually right.
Keep verbatim any lint directives such as oxlint-disable, external links, formulas, and warnings that prevent a bug or data loss. These carry information that cannot be recovered from the code.
Arize-aiVerify and update hand-written docs/ documentation in JS packages against source code.
xxrenzheRebase GitHub pull requests onto main and apply review fixes.
Arize-aiMigrate and upgrade TypeScript tooling across the Phoenix pnpm monorepo.
svoRefactor Python code into self-documenting structure with expressive names.