speckit-backlog-promote

Promote backlog items into active specs via speckit.specify.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/ericstiles/spec-kit-backlog --skill speckit-backlog-promote
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-backlog-promote
Source: https://github.com/ericstiles/spec-kit-backlog/tree/main/.claude/skills/speckit-backlog-promote
Command: npx skills add https://github.com/ericstiles/spec-kit-backlog --skill speckit-backlog-promote

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Promote backlog items into the full spec workflow by converting backlog entries into active specs via speckit.specify.

Core Features & Use Cases

  • Backlog-to-spec promotion: Move items from specs/backlog/ to specs/ when they are ready to become active specs.
  • Inline spec generation: Use the backlog content as the input to speckit.specify to generate a complete spec.
  • Safe cleanup and guardrails: Validate backlog existence, confirm deletion of backlog items after promotion, and handle empty backlog gracefully.

Quick Start

Promote a backlog item by running the command with its slug, for example /speckit.backlog.promote my-feature

Frequently Asked Questions about speckit-backlog-promote

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

FAQPage Schema
How do I promote backlog items to active specs?

To promote backlog items to active specs, invoke the command with the target slug. The skill validates the input, reads the backlog file, and coordinates with speckit.specify to generate the new spec and perform backlog cleanup.

What is the process for converting a backlog entry into a full spec?

Converting a backlog entry into a full spec involves using the backlog content as input to speckit.specify. This moves items from the backlog directory into active work items in the specs directory.

Can I generate specs inline from a backlog-driven workflow?

Yes, you can generate specs inline from a backlog-driven workflow. The skill uses the existing backlog content as the direct input to speckit.specify to generate a complete active spec.

What happens to backlog items after they are promoted to specs?

After backlog items are promoted to specs, the skill performs safe cleanup by confirming the deletion of the original backlog items. It includes guardrails to validate backlog existence and handle empty backlog files gracefully.

How do I validate if a backlog item exists before promoting it?

To validate if a backlog item exists before promotion, the skill applies built-in guardrails that check the backlog file existence before reading the content and invoking the spec generation process.