One-click install
npx skills add https://github.com/gil0mendes/dotfiles --skill plan-review-gil0mendes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-review
Source: https://github.com/gil0mendes/dotfiles/tree/main/configs/opencode/skill/plan-review
Command: npx skills add https://github.com/gil0mendes/dotfiles --skill plan-review-gil0mendes

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured and systematic approach to reviewing implementation plans, ensuring they meet defined quality standards for clarity, completeness, and actionability before execution.

Core Features & Use Cases

  • Structured Checklist: Guides reviewers through specific criteria across Citation Quality, Completeness, and Actionability.
  • Severity Classification: Assigns severity levels (Critical to Nitpick) to findings for prioritization.
  • Standardized Output: Generates reviews in a consistent Markdown format for easy understanding and tracking.
  • Use Case: A product manager needs to ensure a technical plan for a new feature is well-defined, considers edge cases, and provides clear implementation steps before it's handed off to engineers.

Quick Start

Use the plan-review skill to assess the quality of the provided implementation plan.

Frequently Asked Questions about plan-review

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

FAQPage Schema
How do I review an implementation plan for completeness and actionability?

To review an implementation plan for completeness and actionability, use a structured checklist that evaluates citation quality, verifies edge cases, and ensures clear execution steps. This categorizes issues by severity to provide actionable feedback for plan improvement.

What is implementation plan review and when do I need it?

Implementation plan review is a systematic assessment of a technical plan against predefined quality standards before execution. You need it when preparing to hand off a new feature plan to engineers, ensuring it is structured, verifiable, and ready for execution.

How do I check citation quality in a technical implementation plan?

To check citation quality in a technical implementation plan, evaluate references against predefined standards to ensure all claims and technical dependencies are verifiable. This process identifies unsupported citations and categorizes them as issues for plan improvement.

Can I use a structured checklist to assess if a plan is ready for execution?

Yes, you can use a structured checklist to assess if a plan is ready for execution by guiding the review through specific criteria across citation quality, completeness, and actionability. This generates standardized Markdown output that tracks readiness and highlights execution blockers.

How do I prioritize issues found during a plan review?

To prioritize issues found during a plan review, assign severity levels ranging from Critical to Nitpick based on their impact on execution. This severity classification allows you to focus on resolving critical actionability and completeness gaps before minor adjustments.

What are the limitations of using a predefined checklist to review implementation plans?

The limitation of using a predefined checklist to review implementation plans is that it focuses strictly on citation quality, completeness, and actionability metrics. It may not capture subjective strategic misalignment or evaluate domain-specific technical feasibility outside these standard criteria.