add-comment

Convert user input into Asana, Shortcut, Linear, and Jira comment formats.

Updated May 8, 2026
One-click install
npx skills add https://github.com/fractionwork/pm-skills --skill add-comment
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-comment
Source: https://github.com/fractionwork/pm-skills/tree/main/skills/add-comment
Command: npx skills add https://github.com/fractionwork/pm-skills --skill add-comment

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Post comments on PM cards across systems by converting user input (Markdown or plain text) into each system's accepted format, and validating before posting to prevent silent failures.

Core Features & Use Cases

  • Per-system formatting and validation for Asana, Shortcut, Linear, and Jira.
  • Inline mention resolution to correctly tag teammates and drive visibility.
  • Safe post flow with pre-checks, fallbacks, and informative errors when formatting is rejected.

Quick Start

Post a sample comment on a test card to observe per-system formatting and validation in action.

Frequently Asked Questions about add-comment

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

FAQPage Schema
How do I post comments on Jira or Linear cards using Markdown?

To post comments on Jira or Linear, the system detects the host platform from the card URL and converts your Markdown or plain text input into that system's accepted format before submission.

Can I format PM card comments for Asana and Shortcut automatically?

Yes, you can format PM card comments for Asana and Shortcut automatically. The system applies per-system formatting rules and resolves inline mentions to ensure your text is correctly structured for each platform.

Why do my formatted comments fail when posting to project management systems?

Formatted comments often fail due to strict per-system allowlists or invalid mention syntax. This system prevents silent failures by performing validation checks and pre-checks before safely posting your comment.

What is the best way to resolve user mentions in Jira or Asana comments?

The best way to resolve user mentions in Jira or Asana comments is using inline mention resolution. This feature correctly tags teammates and drives visibility by mapping user inputs to the specific platform's mention format.

Does this comment posting approach work across multiple project management tools?

Yes, this comment posting approach works across multiple project management tools. It operates seamlessly across Asana, Shortcut, Linear, and Jira by detecting the host system directly from the provided card URL.

How to validate comment formatting before submitting to a PM card?

To validate comment formatting before submitting to a PM card, the system applies per-system allowlists and validation checks to your text. It provides informative errors if the formatting is rejected.