design

Create and manage Beat change artifacts including proposal, gherkin, and design docs.

7|3|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/kirkchen/beat --skill design-kirkchen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design
Source: https://github.com/kirkchen/beat/tree/main/skills/design
Command: npx skills add https://github.com/kirkchen/beat --skill design-kirkchen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Beat changes can be created and artifacts generated in a structured, repeatable workflow, eliminating ad-hoc design steps and ensuring consistent spec artifacts.

Core Features & Use Cases

  • Create or resume artifact generation for a change
  • Choose artifact presets (Full, Standard, Minimal, Technical, Custom)
  • Automate proposal, gherkin, and design artifact creation and integrate with version control

Quick Start

Describe a new Beat change or select an existing one, then follow the artifact generation flow to produce proposal, gherkin, and design.

Frequently Asked Questions about design

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

FAQPage Schema
How do I generate Gherkin specs and design docs for a new feature change?

To generate Gherkin specs and design docs, create a change container and select an artifact preset, which automatically produces proposal, Gherkin, and design documentation for your feature change.

What's the best way to manage spec artifacts for a feature change without ad-hoc steps?

Managing spec artifacts is best handled by using a structured change workflow that creates a change container and enforces prerequisites like brainstorming, ensuring consistent proposal and design outputs.

Does generating design artifacts require git worktrees and brainstorming?

Yes, generating design artifacts requires brainstorming and using git worktrees to ensure environment isolation and artifact quality before creating proposal and Gherkin documentation.

Can I resume artifact generation for a pending change with different options?

You can resume artifact generation for pending changes by selecting preset options like Full, Standard, Minimal, Technical, or Custom to continue creating the required proposal and design docs.

What are the differences between Full, Standard, and Minimal artifact presets?

Full, Standard, Minimal, Technical, and Custom presets differ by the scope and depth of generated proposal, Gherkin, and design artifacts, allowing tailored documentation for various change management needs.

Why use a change container for brainstorming and feature design?

A change container isolates brainstorming and feature design steps into a structured workflow, eliminating ad-hoc processes and ensuring repeatable, high-quality Gherkin and design artifact generation.