work-on-issue

Parse GitHub issues into goals, acceptance criteria, and constraints.

2.5k|421|Updated Oct 1, 2025
One-click install
npx skills add https://github.com/meta-pytorch/OpenEnv --skill work-on-issue
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: work-on-issue
Source: https://github.com/meta-pytorch/OpenEnv/tree/main/.claude/skills/work-on-issue
Command: npx skills add https://github.com/meta-pytorch/OpenEnv --skill work-on-issue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Start focused work on a GitHub issue by extracting requirements, creating a dedicated worktree, and enforcing a TDD workflow.

Core Features & Use Cases

  • Automated issue scoping: Read and extract goal, acceptance criteria, and constraints from the issue.
  • Worktree creation: Create a dedicated Git worktree per issue to isolate work in a TDD context.
  • Todo generation & TDD: Convert acceptance criteria into actionable tests and begin the TDD cycle automatically.
  • Rapid kickoff: Enables teams to start coding immediately with a clear plan and repo state.

Quick Start

Invoke the skill with an issue number, for example: /work-on-issue #42

Frequently Asked Questions about work-on-issue

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

FAQPage Schema
How do I automate GitHub issue work with Git worktrees?

Automate GitHub issue work by parsing issue goals and acceptance criteria, then automatically create a dedicated Git worktree and initialize test-driven development with auto-generated tests. Invoke with /work-on-issue #[issue-number] to extract requirements, set up isolation, and start the TDD cycle immediately.

What's the best way to start test-driven development on a GitHub issue?

Test-driven development on GitHub issues begins with extracting acceptance criteria and constraints, then converting them into actionable tests within a dedicated worktree. This Skill automates that sequence: parse the issue, generate todos, create the isolated environment, and spawn a workflow that enforces TDD from kickoff.

Can I use Git worktrees to isolate work on multiple issues simultaneously?

Yes. Create a dedicated Git worktree per issue to maintain isolation and prevent branch conflicts. This Skill automates worktree creation and setup for each issue, enabling parallel work streams with clean, independent repository states and TDD workflows running in each context.

How does issue-management automation reduce setup overhead?

Issue-management automation extracts goals, acceptance criteria, and constraints directly from GitHub issues, then chains worktree creation, todo generation, and TDD initialization without manual steps. This eliminates repetitive scoping and environment setup, letting teams begin focused coding immediately with a clear plan.

Do I need prior TDD experience to use automated issue workflows?

No prior TDD expertise is required. This Skill extracts issue requirements and auto-generates tests aligned to acceptance criteria, then structures the workflow around TDD principles. The automation handles test setup and ordering, guiding you through the cycle without demanding existing test-writing knowledge.

What constraints apply to issue parsing and worktree creation?

The Skill extracts goals, acceptance criteria, and constraints from GitHub issue text; accuracy depends on issue clarity and structure. Worktree creation requires an existing Git repository and issue number reference. Multi-issue workflows run in isolation, so resource limits reflect your system's ability to maintain parallel worktrees.