write-integration-ticket

Transform API documentation into structured Linear integration tickets.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/beam-ai-team/beam-next-skills --skill write-integration-ticket
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-integration-ticket
Source: https://github.com/beam-ai-team/beam-next-skills/tree/main/skills/general/write-integration-ticket
Command: npx skills add https://github.com/beam-ai-team/beam-next-skills --skill write-integration-ticket

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

API documentation often sits in isolation, making it hard for engineering teams to convert specifications into actionable tasks tracked in Linear.

Core Features & Use Cases

  • Generate structured API integration specifications ready for Linear import.
  • Capture endpoints, parameters, acceptance criteria, and error handling in a repeatable format.
  • Use case: given API docs, produce a spec that can be imported as a Linear ticket and assigned to the appropriate team.

Quick Start

Provide the API documentation or endpoint details, and I will generate a complete integration ticket specification ready for Linear import.

Frequently Asked Questions about write-integration-ticket

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

FAQPage Schema
How do I turn API documentation into Linear tickets?

To turn API documentation into Linear tickets, provide the endpoint details to generate structured integration specifications. These specifications capture endpoints, parameters, and error handling, producing a format ready for Linear import.

What is an API integration ticket specification?

An API integration ticket specification is a structured format that documents endpoints, parameters, acceptance criteria, and error handling. It translates isolated API docs into actionable tasks ready for import into project management tools like Linear.

How do I create structured Linear tickets from API endpoints?

Create structured Linear tickets from API endpoints by providing the API documentation to generate a consistent specification format. This automated process captures acceptance criteria and error handling, yielding a ready-made ticket for assignment.

Does this API ticket generator require a specific format for Linear import?

Yes, generating API tickets for Linear import requires a frontmatter-defined name and description alongside a consistent specification format. This ensures the resulting integration ticket aligns with standard automated workflow requirements.

Why convert API documentation into structured integration tickets?

Converting API documentation into structured integration tickets solves the problem of isolated specs that are hard to track. It enables automated ticket creation during API work, ensuring endpoints and error handling are actionable within Linear.