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.