setup-work

Generate a structured scratchpad and feature branch from GitHub issues.

1|Updated Dec 28, 2025
One-click install
npx skills add https://github.com/fusupo/escapement --skill setup-work
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: setup-work
Source: https://github.com/fusupo/escapement/tree/main/skills/setup-work
Command: npx skills add https://github.com/fusupo/escapement --skill setup-work

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates turning GitHub issues into fully prepared development environments, including issue context, acceptance criteria, a structured scratchpad, and a ready-to-work feature branch.

Core Features & Use Cases

  • Issue to scratchpad: Generates a structured Scratchpad from a GitHub issue, summarizing context, acceptance criteria, and tasks.
  • Branch planning: Proposes a feature branch name based on issue number and slugified title.
  • Context-aware guidance: Reads CLAUDE.md conventions and project structure to tailor the setup.
  • Workflow readiness: Prepares tasks and quality checks so developers can start work immediately.

Quick Start

Invoke the setup-work skill to initialize work on an issue by running the appropriate command (e.g., /start-work 42). The skill reads CLAUDE.md, builds a scratchpad, and creates a ready-to-work feature branch.

Frequently Asked Questions about setup-work

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

FAQPage Schema
How do I turn a GitHub issue into a ready-to-work development branch?▼

To turn a GitHub issue into a ready-to-work development branch, you can use a workflow automation skill that parses the issue, generates a structured scratchpad with acceptance criteria, and proposes a feature branch name.

What is a scratchpad in the context of issue management and branch planning?▼

A scratchpad in issue management is a structured document summarizing GitHub issue context, acceptance criteria, and tasks, providing developers with immediate workflow readiness before coding begins.

How do I automate creating a feature branch from a GitHub issue number?▼

You can automate feature branch creation from a GitHub issue number by invoking a workflow command, which reads issue context and proposes a branch name based on the issue number and slugified title.

Does workflow automation for branch management require project conventions?▼

Yes, workflow automation for branch management reads project conventions typically stored in a CLAUDE.md file to tailor the generated scratchpad and contextual guidance according to your specific project structure.

Can I generate acceptance criteria and task summaries directly from GitHub issues?▼

Yes, you can generate acceptance criteria and task summaries directly from GitHub issues by extracting the issue context and formatting it into a structured scratchpad for immediate development use.

What are the limitations of automating branch naming from GitHub issues?▼

Automating branch naming from GitHub issues relies on parsing the issue title to create a slugified branch name, meaning non-descriptive or poorly formatted issue titles may result in less optimal branch naming conventions.