skills.rest
drdatarulz
drdatarulzCOMMUNITY
Explore all skills by this author →
GitHub

refine-story

Transform GitHub issues into implementation-ready specifications with phased workflows.

3|Updated Feb 20, 2026
Search Tags:#planning#github#specification#engineering#issue#refine
One-click install
npx skills add https://github.com/drdatarulz/TI-Engineering-Standards --skill refine-story-drdatarulz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: refine-story
Source: https://github.com/drdatarulz/TI-Engineering-Standards/tree/main/skills/archive/refine-story-v1
Command: npx skills add https://github.com/drdatarulz/TI-Engineering-Standards --skill refine-story-drdatarulz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the refining of GitHub issues into full, implementation-ready specifications by analyzing context and surfacing gaps for resolution.

Core Features & Use Cases

  • Phase-driven context gathering and gap analysis
  • Interactive decision refinement with traceable outcomes
  • Automated update of the issue and project board after refinement

Quick Start

Run the interactive refinement process to transform a GitHub issue into an implementation-ready spec following the defined phases.

Frequently Asked Questions about refine-story

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

FAQPage Schema
How do I turn GitHub issues into implementation-ready specifications?▼

To turn GitHub issues into implementation-ready specifications, use an automated refinement process that analyzes project context, surfaces gaps, and guides interactive decisions to output a structured Markdown spec for downstream execution.

What is issue refinement in software engineering planning?▼

Issue refinement in software engineering planning is the process of transforming a raw feature, improvement, or fix request into an actionable specification by analyzing project context and resolving gaps.

How does automated gap analysis work for GitHub issue specification?▼

Automated gap analysis for GitHub issue specification works by evaluating existing issue details against project context, surfacing missing requirements, and guiding interactive decisions to refine the implementation plan.

Can I use this to update my GitHub project board after refining an issue?▼

Yes, you can update your GitHub project board after refining an issue, as the automated refinement process includes updating the issue and project board after generating the specification.

Does this issue refinement process work for fixes and improvements or only new features?▼

This issue refinement process works for fixes, improvements, and new features, applying context gathering and decision refinement to any GitHub issue described as feature work or corrections.

What is the best way to structure a GitHub issue before running an automated refinement?▼

The best way to structure a GitHub issue before automated refinement is to provide a clear description of the feature, improvement, or fix, allowing the system to analyze context and surface gaps for interactive decision refinement.

Related Skills

Explore More Software Engineering Skills→
cdman28cdman28

pdca

Orchestrates the Plan-Do-Check-Act cycle for feature development and iterative improvement.

Community
Advanced
rpamisrpamis
2.7k

comet-design

Produce a Design Doc and delta spec through structured brainstorming.

Official
Advanced
eysenfalkeysenfalk

github-project-management

Manage GitHub projects with AI swarm coordination for issue tracking and sprint planning.

Community
Advanced
ImLpImLp

adr

Generate ADR files in wiki/adrs/ with context, decision, and consequences.

Community
Advanced