Skills
.Work. You
Rest

improve-issue

Official

Clarify issues into implementation-ready specs.

Software Engineering#github#spec writing#acceptance criteria#requirements clarification#ash framework#phoenix liveview#issue enrichment
Authorwadvanced
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill turns a vague or raw GitHub issue into a structured, implementation-ready specification so developers can start coding with clear requirements instead of guessing.

Core Features & Use Cases

  • Issue enrichment and clarification: Ingests the issue (and required linked issues), detects existing enriched-spec drafts, and updates them idempotently.
  • Implementation-grade acceptance criteria: Expands vague requests into concrete, testable, observable behaviors including edge cases and error paths.
  • Ash/Phoenix conventions coverage: Produces specs aligned with project rules like gettext for user-visible strings, soft-delete practices, event audit fields, and LiveView conventions.

Quick Start

Ask the AI to run the improve-issue skill on your GitHub issue (by pasting the issue URL or #number) and update the issue body with an enriched-spec block.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: improve-issue
Download link: https://github.com/wadvanced/aurora_uix/archive/main.zip#improve-issue

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.