Hearing-First Skills

Automate GitHub PR, issue, and merge conflict operations with the gh CLI.

2|1|Updated Sep 5, 2025
One-click install
npx skills add https://github.com/chronista-club/unison --skill hearing-first-skills
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Hearing-First Skills
Source: https://github.com/chronista-club/unison/tree/main/.claude/hearing-first
Command: npx skills add https://github.com/chronista-club/unison --skill hearing-first-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents costly rework and miscommunications by providing a structured, incremental approach to gathering user requirements and making technical decisions before implementation begins, ensuring alignment and efficiency.

Core Features & Use Cases

  • Phased Questioning: Breaks down complex tasks into major categories (e.g., branch configuration, technical stack, architecture) and smaller, actionable questions.
  • Structured Choices: Offers concrete options for users, simplifying decision-making and ensuring clarity, while also allowing for custom input.
  • Early Alignment: Identifies and resolves misunderstandings early in the development cycle, reducing project risk and improving stakeholder satisfaction.
  • Use Case: Before starting a new feature like a MIDI/OSC server, use this skill to systematically ask the user about preferred branch naming, technical stack (e.g., MIDI/OSC libraries), architecture design, and functional scope.

Quick Start

Use the Hearing-First Skills to initiate a new feature development by asking the user about the preferred branch name and worktree directory, providing clear options.

Frequently Asked Questions about Hearing-First Skills

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

FAQPage Schema
How do I gather user requirements before starting development?

Gathering requirements incrementally through structured questioning prevents costly rework. This approach breaks complex tasks into major categories and actionable questions, offering concrete options to users while allowing custom input, ensuring alignment before implementation begins.

What's the best way to make technical decisions with stakeholders early?

Early alignment identifies and resolves misunderstandings before development starts. Use phased questioning to systematically explore preferred branch naming, technical stack, architecture design, and functional scope, reducing project risk and improving stakeholder satisfaction.

How do I structure decision-making for a new feature?

Structure choices using concrete options rather than open-ended questions. Initiate feature development by asking users about preferred branch names and worktree directories, technical preferences like libraries and frameworks, and architecture design decisions in a phased, auditable manner.

Can I use an incremental approach to avoid miscommunications?

Incremental requirement gathering with structured choices simplifies decision-making and ensures clarity. This phased approach captures user intent early, resolves ambiguities before implementation, and maintains stakeholder alignment throughout the development cycle.

When should I align on requirements with my team?

Align before implementation begins to prevent costly rework and miscommunications. Use this skill when initiating a new feature, establishing branch configuration, selecting technical stack, and defining architecture—all before writing production code.