polishing-issues

Transform vague GitHub issues into actionable scope blocks with acceptance criteria.

2|Updated Nov 29, 2023
One-click install
npx skills add https://github.com/chrisrodz/dotfiles --skill polishing-issues
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: polishing-issues
Source: https://github.com/chrisrodz/dotfiles/tree/main/ai/skills/polishing-issues
Command: npx skills add https://github.com/chrisrodz/dotfiles --skill polishing-issues

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Turn a vague or incomplete GitHub issue into a concise, executable spec that a coding agent can implement without back-and-forth.

Core Features & Use Cases

  • Scope drafting: generate a focused scope block with assumptions, goals, touchpoints, and acceptance criteria.
  • Template-driven: outputs a ready-to-edit scope block that mirrors the issue structure.
  • Validation-ready: includes a task breakdown with inputs, outputs, steps, and validation parameters.

Quick Start

Draft a concise scope block for the given issue and append it to the issue body

Frequently Asked Questions about polishing-issues

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

FAQPage Schema
How do I turn a vague GitHub issue into an actionable spec for a coding agent?

To turn a vague GitHub issue into an actionable spec, the Skill extracts context and generates a self-contained scope block with explicit touchpoints, acceptance criteria, and a task breakdown ready for immediate work.

What is the best way to add acceptance criteria and validation to an issue lacking clear scope?

The best way to add acceptance criteria and validation is by generating a template-driven scope block that includes API/data changes, edge cases, and a task breakdown with explicit inputs, outputs, and validation parameters.

How do I create a task breakdown from a GitHub issue for small verifiable tasks?

You create a task breakdown by transforming the issue into a structured scope block, which divides the work into small, verifiable tasks complete with required modification touchpoints and validation parameters.

Can I automatically draft a focused scope block with assumptions and goals from an existing issue?

Yes, you can automatically draft a focused scope block that mirrors the issue structure, integrating assumptions, goals, and modification touchpoints into a ready-to-edit template appended to the issue body.

Does this approach work for preparing GitHub issues for automated coding without back-and-forth communication?

Yes, this approach works for automated coding by producing a concise, executable spec that handles issues lacking clear scope, ensuring a coding agent can implement the work without back-and-forth clarification.