spec-to-workitem

Translate NONoise sprint manifest macro tasks into external issue tracker work items.

5|Updated Apr 18, 2026
One-click install
npx skills add https://github.com/russosalv/NONoise --skill spec-to-workitem
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-to-workitem
Source: https://github.com/russosalv/NONoise/tree/main/packages/skills/spec-to-workitem
Command: npx skills add https://github.com/russosalv/NONoise --skill spec-to-workitem

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Translates macro functional tasks from a NONoise sprint manifest into external issue tracker work items so teams can reliably populate backlogs without manual copy-paste, duplicate issues, or credential leakage. It enforces idempotency, previews changes in dry-run mode, and centralizes tracker-specific logic in pluggable adapters so the source-of-truth is never mutated inadvertently.

Core Features & Use Cases

  • Adapter-driven exports: Supports dry-run, GitHub Issues, Azure DevOps, Jira, and Linear with a clear adapter contract for create, list, update, and search_by_external_id.
  • Idempotent, auditable pushes: Finds existing items by task ID, classifies NEW/EXISTS/AMBIGUOUS, and asks before updating; produces a local export summary for traceability.
  • Dependency and metadata mapping: Two-pass creation to resolve dependency links, maps effort, components, confidence labels, and sprint/milestone fields per adapter.
  • Robust error handling: Stops on auth failures, retries on transient errors with backoff, and reports per-item failures without aborting the whole run.

Quick Start

Run the spec-to-workitem skill to dry-run export Sprint 5 to GitHub issues.

Frequently Asked Questions about spec-to-workitem

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

FAQPage Schema
How do I export sprint tasks to Jira or GitHub Issues from a sprint manifest?

You can export sprint tasks to issue trackers by running a dry-run preview first, then applying adapter-driven creation with idempotent external_id matching and two-pass dependency linking to populate backlogs safely.

Can I preview backlog items before creating work items in Azure DevOps?

Yes, you can preview backlog items before creating work items in Azure DevOps by using dry-run mode, which classifies tasks as NEW, EXISTS, or AMBIGUOUS and reports changes without mutating the source-of-truth or pushing to the tracker.

How does idempotent work item creation prevent duplicate issues in Linear or Jira?

Idempotent work item creation prevents duplicate issues in Linear or Jira by searching for existing items by task ID via adapter contracts, classifying matches, and asking before updating, ensuring repeated exports do not create redundant tracker entries.

Do I need environment variables to authenticate with GitHub Issues and Azure DevOps adapters?

Yes, you need environment variables to authenticate with GitHub Issues and Azure DevOps adapters, as the export process applies adapter-based authentication through environment variables and stops execution immediately upon detecting authentication failures.

What happens when transient errors occur during sprint manifest export to issue trackers?

When transient errors occur during sprint manifest export to issue trackers, the process retries with backoff and reports per-item failures without aborting the entire run, allowing successful items to complete while isolating individual errors.

How are task dependencies and metadata mapped when exporting sprint manifests to work items?

Task dependencies and metadata are mapped during export using a two-pass creation process that resolves dependency links first, then maps effort, components, confidence labels, and sprint or milestone fields according to each tracker's specific adapter contract.