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.