skills.rest
seal-harness
seal-harnessOFFICIAL
Explore all skills by this author →
GitHub

create-issue

Generates structured GitHub issues with TDD plans, acceptance criteria, and agent instructions.

1|Updated Jun 23, 2026
Search Tags:#automation#tdd#code review#pull request#github#gh cli#issue creation
One-click install
npx skills add https://github.com/seal-harness/seal-harness --skill create-issue-seal-harness
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-issue
Source: https://github.com/seal-harness/seal-harness/tree/main/.agents/skills/create-issue
Command: npx skills add https://github.com/seal-harness/seal-harness --skill create-issue-seal-harness

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing GitHub issues that autonomous agents can execute end-to-end is tedious and error-prone; vague issues lead to incomplete PRs, missed review feedback, and stalled merges. This Skill produces self-contained work packets that carry an issue from specification through implementation, code review, and squash merge. ## Core Features & Use Cases - Interactive issue scoping: Walks the user through issue type (feature, bug, refactor), description, complexity, and codebase context before generating content. - Template-driven generation: Produces issues with problem statements, technical specifications, TDD test cycles, acceptance criteria, and phased implementation plans. - Full PR lifecycle agent instructions: Embeds protocols for research, implementation, review-comment handling, thread resolution, and squash merge cleanup. - Use Case: A maintainer needs a new caching service built. They run the skill, answer four prompts, and receive a GitHub issue containing Zod schemas, TDD cycles, and step-by-step agent instructions that an autonomous agent follows through to a merged PR. ## Quick Start Ask the assistant to create a GitHub issue for a new feature, bug, or refactor and answer the follow-up questions about scope and complexity.

Frequently Asked Questions about create-issue

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

FAQPage Schema
How do I create a GitHub issue with a TDD implementation plan?▼

Invoke the skill and answer the interactive prompts for issue type, description, and complexity. It generates an issue containing test-first TDD cycles, acceptance criteria, and phased implementation tasks, then creates it via the gh CLI with appropriate labels.

What issue types does this GitHub issue generator support?▼

It supports three types: features, bugs, and refactors. Each uses a tailored template, such as bug reports with reproduction steps and root cause analysis, or refactors referencing the review feedback that triggered the work.

Does this skill require the GitHub CLI to work?▼

Yes, issue creation and the embedded agent instructions rely on the gh CLI for creating issues, fetching PR review comments, replying to threads, resolving review threads via GraphQL, and performing squash merges.

How are code review comments handled in the generated agent instructions?▼

The instructions require fetching all PR comments, addressing every one including trivial and out-of-scope items, replying to each thread individually, and resolving threads only after reviewer approval. Work exceeding one day is deferred into new linked issues.

When should I not use this issue creation workflow?▼

It is heavyweight for trivial one-line fixes or repositories without a PR review process. The full lifecycle protocol assumes TDD, CI checks, and reviewer-driven thread resolution, which may not fit solo or informal projects.

Related Skills

Explore More Software Engineering Skills→
michael-watsonmichael-watson
8

rpi-research

Analyze codebase architecture, dependencies, and constraints into a research document.

Community
Intermediate
homeassistant-aihomeassistant-ai
4.3k

issue-to-pr-resolver

Automate GitHub issue resolution into a merge-ready pull request.

Official
Advanced
githubgithub
5.1k

pr-review-response

Replies to GitHub PR review comment threads after fixing flagged code issues.

Official
Intermediate
dsifrydsifry

create-issue

Create structured GitHub issues with embedded agent instructions for PR lifecycle management.

Community
Advanced