planning-task-completion-gate

Classify previous GitHub issue or pull request completion before planning sessions.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/ai212983/gh-csi --skill planning-task-completion-gate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning-task-completion-gate
Source: https://github.com/ai212983/gh-csi/tree/main/skills/planning-task-completion-gate
Command: npx skills add https://github.com/ai212983/gh-csi --skill planning-task-completion-gate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents starting a new planning or scoping session when the prior GitHub issue or pull request may still be incomplete, avoiding duplicated effort, lost context, and conflicting work.

Core Features & Use Cases

  • Precheck Classification: Delegates to the gh-csi workflow precheck-previous-task script to classify a referenced issue or PR as completed, not_completed, or unknown.
  • Decision Gate: Returns a concise structured precheck (status, task reference, evidence, decision) and prompts for confirmation when the prior task is not completed or status is unclear.
  • Real-world Use Case: Use when a user says "let's plan issue #11" so the agent verifies the preceding task state and either proceeds, asks to continue anyway, or requests clarification.

Quick Start

Ask the agent to run the planning completion gate for issue #11 to verify whether the previous task is completed before drafting a new plan.

Frequently Asked Questions about planning-task-completion-gate

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

FAQPage Schema
How do I verify a previous GitHub issue is completed before planning a new task?

Verifying previous GitHub issue completion before planning involves running a precheck script with an issue number flag to classify its state as completed, not_completed, or unknown. This decision gate prevents overlapping work by ensuring the prior task is finished before starting a new scoping session.

What is a planning completion gate in GitHub workflow automation?

A planning completion gate in GitHub workflow automation is a precheck mechanism that classifies the state of a referenced issue or PR before starting new work. It returns a structured status to ensure continuity and prevent conflicting efforts across sequential tasks.

How do I run a precheck on a GitHub PR before starting a scoping session?

To run a precheck on a GitHub PR before starting a scoping session, execute the gh-csi workflow precheck-previous-task script using the --pr flag. This produces a classification of the PR's completion state to gate your planning decision.

Does the precheck script work with both GitHub issues and pull requests?

Yes, the precheck script works with both GitHub issues and pull requests by accepting optional --issue or --pr flags. It evaluates the specified reference and outputs a completed, not_completed, or unknown classification for decision gating.

What happens if a prior GitHub task is not completed when I try to plan the next one?

If a prior GitHub task is not completed when you try to plan the next one, the precheck gate returns a not_completed status and prompts for confirmation. This structured response asks whether you want to continue anyway or request clarification before drafting new work.