issue-editing

Prevents stale GitHub/Jira issue edits via fetch-before-edit validation.

8|1|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/bordenet/superpowers-plus --skill issue-editing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issue-editing
Source: https://github.com/bordenet/superpowers-plus/tree/main/skills/issue-tracking/issue-editing
Command: npx skills add https://github.com/bordenet/superpowers-plus --skill issue-editing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents stale, conflicting, or hallucinated edits to existing issues by enforcing a fetch-before-edit workflow and validating field changes before mutation. It reduces race conditions, accidental overwrites, and edits based on guessed identifiers.

Core Features & Use Cases

  • Fetch-before-edit enforcement: Always call get_issue and use the returned state as the authoritative base before updating.
  • Field validation: Verify status, assignee identifiers, labels, priorities, titles, and descriptions against platform-specific rules.
  • Concurrent edit detection: Check updatedAt timestamps and surface recent modifications with options to proceed, refetch, or cancel.
  • Workflow guardrails: Block edits of non-issue entities, prevent fabricated identifiers, and require valid status transitions.
  • Use Cases: Updating issue status or assignee, bulk-updating labels, editing titles/descriptions, and post-edit verification.

Quick Start

Fetch the current issue state with get_issue, confirm exists and entityType is "issue", then apply the intended status and assignee updates only after validation.

Frequently Asked Questions about issue-editing

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

FAQPage Schema
How do I prevent stale updates when editing issues in Jira or GitHub?

Prevent stale updates by enforcing a fetch-before-edit workflow: call get_issue to retrieve the current state, validate entityType and field values, then check updatedAt timestamps to detect concurrent modifications before applying any mutations to issues.

How does concurrent edit detection work for issue tracking?

Concurrent edit detection checks the updatedAt timestamp retrieved from get_issue. If the timestamp indicates a recent modification, the workflow surfaces the conflict and provides options to proceed with the edit, refetch the current state, or cancel the update entirely.

Can I bulk update labels and assignees without overwriting recent issue changes?

Yes, you can bulk update labels and assignees safely by first fetching the existing issue state, validating assignee identifiers and labels against platform-specific rules, and confirming the updatedAt timestamp has not changed since retrieval before applying the bulk edit mutation.

What is the best way to validate status transitions before updating a ticket?

The best way to validate status transitions is to fetch the issue using get_issue, verify the entityType is exactly an issue, and check the intended status change against platform-specific rules and valid transition paths before executing the update mutation.

Why do my issue edits fail with hallucinated or invalid identifiers?

Issue edits fail with hallucinated identifiers because the workflow requires fetching the actual issue state first. Blocking edits of non-issue entities and validating assignee and field values against retrieved data prevents fabricated identifiers from being used in mutations.

Do I need to fetch an issue before editing its title or description?

Yes, you need to fetch an issue before editing its title or description. The fetch-before-edit enforcement requires calling get_issue to establish the authoritative base state, ensuring title and description edits do not accidentally overwrite concurrent modifications made by other users.