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.