temporary-id-safe-output

Resolve temporary IDs to GitHub issue numbers within agent-driven workflows.

4.9k|489|Updated Aug 12, 2025
One-click install
npx skills add https://github.com/githubnext/gh-aw --skill temporary-id-safe-output
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: temporary-id-safe-output
Source: https://github.com/githubnext/gh-aw/tree/main/skills/temporary-id-safe-output
Command: npx skills add https://github.com/githubnext/gh-aw --skill temporary-id-safe-output

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the challenge of linking newly created GitHub issues within the same AI workflow run by introducing temporary IDs, enabling complex, multi-step automation where issue numbers are not immediately available. It allows AI agents to build intricate issue hierarchies seamlessly.

Core Features & Use Cases

  • Temporary ID Resolution: Use placeholder IDs (aw_XXXXXXXXXXXX) that are automatically resolved to actual GitHub issue numbers at execution time.
  • Producer-Consumer Model: Understand how create_issue jobs produce temporary ID maps and how other jobs consume them.
  • Robust Failure Handling: Jobs log warnings for resolution failures, ensuring partial success and preventing catastrophic workflow halts.
  • Use Case: An AI agent needs to create a parent issue and then immediately create and link several sub-issues to it. This skill describes the mechanism that allows the agent to use placeholder IDs which are resolved to actual issue numbers during execution.

Quick Start

Consult the temporary-id-safe-output skill to understand how temporary IDs are used to link a newly created parent issue with sub-issues in a single workflow run.

Frequently Asked Questions about temporary-id-safe-output

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

FAQPage Schema
How do I link newly created GitHub issues within the same workflow run?

Link newly created GitHub issues by using temporary IDs that resolve to real issue numbers during execution. This Skill bridges the gap between placeholder IDs and actual GitHub issue identifiers, enabling multi-step automation where issue numbers aren't immediately available.

What are temporary IDs and how do they work in GitHub workflows?

Temporary IDs are placeholder identifiers (format: aw_XXXXXXXXXXXX) that AI agents use to reference issues before they're created. The Skill automatically maps these placeholders to real GitHub issue numbers at runtime, allowing agents to build issue hierarchies and link sub-issues within a single workflow run.

Can I create and link parent and sub-issues in one GitHub workflow?

Yes. This Skill enables agent-driven workflows to create a parent issue and immediately link multiple sub-issues to it in a single run by using temporary ID resolution, without waiting for real issue numbers to be assigned.

How do jobs share temporary ID mappings in GitHub workflows?

Jobs pass the GH_AW_TEMPORARY_ID_MAP through workflow needs, implementing a producer-consumer model where create_issue jobs produce the mapping and other jobs consume it to resolve placeholder IDs to actual GitHub issue numbers.

What happens if temporary ID resolution fails in my workflow?

Jobs log warnings for resolution failures and continue executing, ensuring partial success and preventing the entire workflow from halting due to unresolved temporary IDs.