qa-shortcut-integration

Create and update Shortcut stories, epics, and iterations via REST API v3.

2|2|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/AZANIR/qa-skills --skill qa-shortcut-integration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qa-shortcut-integration
Source: https://github.com/AZANIR/qa-skills/tree/main/.cursor/skills/qa-shortcut-integration
Command: npx skills add https://github.com/AZANIR/qa-skills --skill qa-shortcut-integration

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines your QA workflow by directly integrating it with Shortcut, automating the creation and management of stories, epics, and iterations.

Core Features & Use Cases

  • Automated Story Creation: Generate Shortcut stories from bug reports, QA tasks, or coverage gaps.
  • Metadata Sync: Map QA details like severity and component to Shortcut labels and story types.
  • Workflow Integration: Update story statuses and link to test cases or requirements.
  • Use Case: When a critical bug is found, this Skill can automatically create a "bug" type story in Shortcut, assign it a "critical" label, and link it to the relevant test case.

Quick Start

Use the qa-shortcut-integration skill to create a new Shortcut story from the provided bug report details.

Frequently Asked Questions about qa-shortcut-integration

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

FAQPage Schema
How do I automatically create Shortcut stories from bug reports?

By mapping QA metadata like severity and component to Shortcut labels and story types, this Skill leverages Shortcut REST API v3 to generate stories directly from your bug reports.

Can I sync QA workflow statuses with Shortcut story states?

Yes, the Skill synchronizes QA status updates directly with Shortcut workflow states using API v3, ensuring project tracking remains current without manual updates.

Does the Shortcut API integration support linking external test cases to stories?

Yes, it facilitates connecting external test cases and requirements directly to the relevant Shortcut stories and epics through API v3 metadata mapping.

How do I map QA priority and component metadata to Shortcut labels?

The Skill translates QA bug report details like priority and component into corresponding Shortcut story types and labels via API v3, ensuring issues are tagged appropriately.

What is the best way to manage Shortcut epics and iterations from a QA workflow?

Automating creation and updates through Shortcut REST API v3 is the best way, mapping QA coverage gaps and tasks directly to Shortcut iterations for seamless project management.

Do I need the Shortcut REST API v3 to integrate QA workflows with Clubhouse?

Yes, Shortcut REST API v3 is required to integrate QA workflows with the platform formerly known as Clubhouse, handling story creation and metadata mapping.