review-task

Reviews task descriptions for clarity, completeness, and prompt-craft quality, generating scoring and improvement guidance.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/novel-jp/projsight-plugin --skill review-task-novel-jp
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: review-task
Source: https://github.com/novel-jp/projsight-plugin/tree/main/skills/review-task
Command: npx skills add https://github.com/novel-jp/projsight-plugin --skill review-task-novel-jp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill reviews task descriptions for clarity, completeness, and prompt-craft quality so teams can quickly spot weak briefs before work begins.

Core Features & Use Cases

  • Five-point scoring: Evaluates background, required actions, done conditions, scope limits, and self-containment on a 0–2 scale each.
  • Actionable feedback: Explains exactly what is missing or unclear and gives concrete improvement suggestions instead of vague criticism.
  • Revision-ready output: Produces a structured review plus an optional rewritten task description when the brief needs substantial improvement.
  • Use case: A project manager can paste a ticket description and get a consistent review that helps make the work easier for engineers or collaborators to execute.

Quick Start

Paste a task description or task ID and ask the Skill to review it for clarity, missing context, and improvement opportunities.

Frequently Asked Questions about review-task

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

FAQPage Schema
How do I review task descriptions for clarity and completeness before assigning them?▼

Reviewing task descriptions involves evaluating background, required actions, done conditions, scope limits, and self-containment. You can score each dimension on a 0–2 scale to identify missing context and generate actionable feedback for improvement.

What is the best way to score and fix weak task briefs or issue tickets?▼

Scoring weak task briefs uses a five-point evaluation across background, actions, done conditions, scope, and self-containment. Fixing them involves applying actionable feedback to clarify missing context and optionally generating a revision-ready rewrite of the description.

How do I write better acceptance criteria and scope limits for project tasks?▼

Writing better acceptance criteria and scope limits requires checking the task description for self-containment and clear done conditions. Evaluating these dimensions with a structured review ensures collaborators understand exactly when the work is complete and what falls outside the project scope.

Does this task review process work for any project management ticket format?▼

Yes, this task review process applies to issue tickets, project tasks, and assignment briefs across any format. It measures prompt-craft quality and structural completeness to ensure the brief provides sufficient background and scope limits for engineers.

Why does my task description score low on self-containment and prompt-craft quality?▼

Task descriptions score low on self-containment and prompt-craft quality when they lack sufficient background context, clear required actions, or defined done conditions. A structured review identifies these specific gaps and provides concrete suggestions to make the brief executable.

Can I automatically generate an improved rewrite of a weak issue ticket description?▼

Yes, you can generate a revision-ready rewrite of a weak issue ticket description. When the task brief needs substantial improvement, the review process produces a structured, rewritten version that incorporates the missing background, scope limits, and acceptance criteria.