One-click install
npx skills add https://github.com/Cygnusfear/pi-extensions --skill review-comments-cygnusfear
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-comments
Source: https://github.com/Cygnusfear/pi-extensions/tree/main/skills/review-comments
Command: npx skills add https://github.com/Cygnusfear/pi-extensions --skill review-comments-cygnusfear

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents agents from accidentally deleting or drifting away from inline code review markers by tying each // @mai: comment to a backed mai ticket and enforcing a safe lifecycle for resolving them.

Core Features & Use Cases

  • Create and manage inline review markers: Use // @mai: [pe-xxxx] comments to represent issues directly in code.
  • Resolution tracking with mai tickets: Ensure each marker is backed by a mai ticket, supports adding resolution notes, and closing the ticket.
  • Drift detection and guardrails: Detect when markers disappear without closing tickets and block edits that would cause drift.
  • Thread visibility for agents: Let agents list, show, resolve, and check review comments as part of their editing workflow.
  • Works with multi-line blocks: Capture continuation lines under the same comment prefix into a single ticket payload.

Quick Start

Use the review-comments Skill while editing the file containing // @mai: markers so the agent can list open comments, apply fixes, add resolution notes to the linked mai ticket, close it, and safely remove the corresponding // @mai: line.

Frequently Asked Questions about review-comments

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent agents from deleting inline code review comments during editing?

To prevent agents from deleting inline code review comments, you need a lifecycle management system that links markers like // @mai: comments to backed tickets and enforces safe editing rules. This blocks edits that would remove unresolved markers and detects disappearance-based drift via comment scanning.

How do I track resolution of inline code annotations across ongoing work sessions?

You can track inline code annotation resolution by linking each comment to a mai ticket. Agents can then add resolution notes, close the linked ticket, and safely remove the corresponding comment line, maintaining consistent lifecycle management across ongoing work sessions.

What is drift detection for inline review markers and how does it work?

Drift detection for inline review markers works by scanning source files to detect when comments disappear without their linked mai tickets being closed. It blocks edits that would cause drift, reads open marker threads, and verifies if unresolved annotations have been accidentally removed.

Can I manage multi-line code review comments as a single ticket payload?

Yes, multi-line code review comments can be managed as a single ticket payload. The system captures continuation lines under the same comment prefix, treating the entire multi-line block as one linked issue tied to a single mai ticket for resolution tracking.

Does blocking edits that remove unresolved review markers work with existing source files?

Yes, blocking edits that remove unresolved review markers works with existing source files. The system reads open marker threads embedded in the code, checks for drift, and prevents agents from editing out any unresolved inline annotations during active work sessions.

What's the best way to list and verify open code annotations before applying fixes?

The best way to list and verify open code annotations is to use an agent workflow that scans the file for // @mai: comments, shows open threads, and checks for drift. This ensures all unresolved markers are visible and backed by tickets before any fixes are applied.