Does it add comments to every line of code?

No, it is specifically designed to ignore the obvious and only add insights that a human might omit or that clarify the non-obvious goals of a specific implementation.

Why use PM-style comments instead of standard documentation?

While standard documentation explains how a function works, PM comments explain why a specific change was requested and how it aligns with project milestones.

How does it help with the code review process?

It shifts the focus from technical syntax to project-level intent, making it significantly easier for reviewers to grasp the 'big picture' and intent of your changes.

What does the Project Manager Comments skill do?

It reviews your code changes and automatically inserts high-level comments that explain the business context and purpose, helping teammates understand the reasoning behind complex logic.

Will it mess up my code formatting?

No, the skill is explicitly instructed to add comments that are consistent with the existing style and formatting of your files.

Project Manager Comments

Name: Project Manager Comments
Author: segersniels

bysegersniels

0•

Collaboration Tools

Inserts high-level project management context and business logic insights directly into code changes to improve team communication.

The Project Manager Comments skill bridges the gap between technical implementation and project-level intent by acting as a virtual PM during the coding process. It analyzes your recent changes and adds high-level commentary that explains the 'why' behind the code, focusing on the purpose of complex modifications rather than just the syntax. By filtering out obvious technical details and maintaining file consistency, it helps colleagues and reviewers understand the broader impact of a change, making it an essential tool for teams handling sophisticated features or legacy codebases.

Key Features

01Translates complex technical shifts into readable team insights

02Excludes obvious technical explanations to reduce noise

03Adds high-level business logic and context comments

04Ensures comments are consistent with existing file styles

050 GitHub stars

06Reviews code changes from a project management perspective

Use Cases

01Explaining the business rationale behind a complex architectural change

02Preparing codebases for review by highlighting high-level project impact

03Providing context for non-obvious bug fixes to assist future maintainers

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add segersniels/dotfiles pm-comment

For use in Claude.ai and ChatGPT

Download Skill