chrismccoy

Docblock Rewrite — Development skill for Claude Code

Development community

Convert PHPDoc and JSDoc blocks into one-line plain-English // comments.

How to install Docblock Rewrite

Installs to ~/.claude/skills/chrismccoy-forge-docblock-rewrite/SKILL.md

Terminal

mkdir -p ~/.claude/skills/chrismccoy-forge-docblock-rewrite && curl -fsSL https://raw.githubusercontent.com/chrismccoy/forge/HEAD/commands/docblock-rewrite.md -o ~/.claude/skills/chrismccoy-forge-docblock-rewrite/SKILL.md

Restart Claude Code, or start a new session, for it to be picked up.

What Docblock Rewrite does

description: Convert PHPDoc and JSDoc blocks into one-line plain-English // comments. Scripted bulk pass over a directory or single file. Backs up originals to .bak, validates output against banned-words list and 100-char cap, replaces in place. Honors @internal/@deprecated/@ignore opt-outs. allowed-tools: Read, Bash disable-model-invocation: true

**Load first.** Read `${CLAUDE_PLUGIN_ROOT}/lib/docblock-rewrite/SKILL.md` in full before anything else - intake, tool calls, or output.

Alternatives in Development

Remove Comments — Remove Obvious Comments 2.8k ★
Comments — /comments Command 849 ★
Herdr Reviewr — Review your coding agent's diff in a terminal pane and send line comments back to Claude Code, Codex, OpenCode 823 ★