workflow-comments

Standardize task workflow updates with structured JSON comment templates.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/productengineered/parsely --skill workflow-comments-productengineered
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workflow-comments
Source: https://github.com/productengineered/parsely/tree/main/.claude/skills/workflow/workflow-comments
Command: npx skills add https://github.com/productengineered/parsely --skill workflow-comments-productengineered

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Task workflow updates are often described with inconsistent language and formats, leading to unclear histories and slower reviews. This Skill defines a structured, language- and format-consistent approach for commenting during implementation, testing, handoff, and fixes.

Core Features & Use Cases

  • Comment Types: note, implementation, testing, handoff, review, rejection, fix
  • Structured payloads: provides JSON-based base and trackable comment templates with required fields (id, timestamp, author, type, content) and rejection-specific fields
  • Sequencing & rules: enforces next-action sequencing, ISO 8601 timestamps, and rule-based changes for workflow fields
  • Practical examples: templates and payloads for typical development cycles (implementation -> review -> handoff or rejection)

Quick Start

Use the workflow-comments skill to format a new task update comment for an implementation step in the current sprint.

Frequently Asked Questions about workflow-comments

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

FAQPage Schema
How do I standardize task comments for implementation and review cycles?

To standardize task comments, apply structured JSON templates with required fields like id, timestamp, author, type, and content to enforce consistent documentation across implementation, review, and fix cycles.

What are structured task workflow comment types and when do I need them?

Structured task workflow comment types include note, implementation, testing, handoff, review, rejection, and fix. You need them when inconsistent language and formats are slowing down collaborative project reviews.

How do I format a task update comment for a development handoff?

Format a task update comment by using JSON-based templates that enforce next-action sequencing and ISO 8601 timestamps, ensuring clear handoffs and trackable histories during development cycles.

Can I use JSON templates to enforce process guidelines for task management?

Yes, you can use JSON templates to enforce process guidelines by defining required fields and rule-based changes for workflow fields, ensuring consistent documentation across collaborative environments.

What is the best way to handle rejection comments in a task workflow?

The best way to handle rejection comments is using structured payloads with rejection-specific fields, ensuring clear documentation and proper next-action sequencing within the task workflow.

Are structured task workflow comments suitable for fix cycles in collaborative environments?

Yes, structured task workflow comments are suitable for fix cycles in collaborative environments, providing consistent formats and trackable histories that speed up reviews and maintain clear communication.