update-issue

Update GitHub or GitLab issues to reflect Ralf story state changes.

4|2|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/anis-marrouchi/ralf --skill update-issue-anis-marrouchi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-issue
Source: https://github.com/anis-marrouchi/ralf/tree/main/skills/update-issue
Command: npx skills add https://github.com/anis-marrouchi/ralf --skill update-issue-anis-marrouchi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically synchronize external issue trackers (GitHub/GitLab) with Ralf story state changes, reducing manual updates and keeping project management in sync with execution progress.

Core Features & Use Cases

  • Platform-aware updates: updates GitHub Issues or GitLab issues as stories change in Ralf.
  • Status synchronization: reflects on-start, on-complete, and on-blocked events with appropriate labels, comments, and optional closures.
  • Hook-ready integration: designed to run from lifecycle hooks and respect project-level configuration.

Quick Start

Use this skill to automatically update the linked GitHub or GitLab issue when a Ralf event occurs.

Frequently Asked Questions about update-issue

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

FAQPage Schema
How do I automatically update GitHub Issues when a task starts or completes?

You can automatically update GitHub Issues by running the update-issue skill during the Ralf execution lifecycle. It detects the platform, resolves issue references, and applies labels, comments, or closures based on story state changes.

Can I sync GitLab issues with Ralf story progress automatically?

Yes, the update-issue skill supports syncing Ralf story states with GitLab issues. It uses platform detection to apply appropriate labels, comments, and optional re-opening actions via glab or MCP commands.

What is the best way to keep issue trackers in sync with development workflows?

The best way to keep issue trackers in sync is using a hook-ready integration like the update-issue skill. It reflects on-start, on-complete, and on-blocked events from the Ralf lifecycle directly to GitHub or GitLab.

Do I need gh or glab installed to update issue trackers from Ralf?

Yes, you need either the gh or glab CLI tools installed to update issue trackers from Ralf. The update-issue skill relies on these tools or MCP commands to manage labels, comments, and issue closures.

How do I configure issue reference resolution for Ralf story synchronization?

You configure issue reference resolution and platform settings in the .ralf/config.json file. This configuration allows the update-issue skill to correctly map Ralf story state changes to the corresponding GitHub or GitLab issues.

Why are my issue tracker labels not updating when a story is blocked?

Labels may not update if the platform detection or issue reference resolution fails. Ensure your .ralf/config.json is correctly configured and that the update-issue skill is properly hooked into the Ralf lifecycle events.