aped-from-ticket

Convert external ticket content into a structured APED story artefact.

2|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/yabafre/aped-claude --skill aped-from-ticket
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aped-from-ticket
Source: https://github.com/yabafre/aped-claude/tree/main/src/templates/skills/aped-from-ticket
Command: npx skills add https://github.com/yabafre/aped-claude --skill aped-from-ticket

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the manual, error-prone work of translating an external ticket (Linear/Jira/GitHub/GitLab/ClickUp) into an APED-conformant story, including placement decisions, acceptance criteria drafting, and safe handoff.

Core Features & Use Cases

  • External ticket intake: Fetches the ticket content, extracts key details (title, description, labels/status, assignees, recent comments), and uses it as the source of truth for the story draft.
  • APED placement & scoping: Chooses where the story belongs (epic bucket, auto-match, or interactive selection) and prevents duplicate intake for tickets already planned.
  • Artefact + state updates with guardrails: Writes the story to the correct location and registers it in state.yaml without automatically running dev, with optional comment-back to the source ticket.

Quick Start

Run aped-from-ticket with your ticket ID or URL so the Skill can draft a ready-for-dev story and register it in state.yaml.

Frequently Asked Questions about aped-from-ticket

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

FAQPage Schema
How do I convert a Jira or Linear ticket into a ready story with acceptance criteria?

Ticket intake fetches external ticket details and converts them into a structured story artefact with acceptance criteria, correct placement, and state registration. It extracts titles, descriptions, labels, and comments to draft a ready-for-dev story.

Can I ingest tickets from GitHub issues or GitLab issues into my story workflow?

Yes, ticket intake supports GitHub issues and GitLab issues alongside Linear, Jira, and ClickUp. It fetches the ticket content and uses it as the source of truth to draft an APED-conformant story artefact for your project.

Does ticket intake prevent duplicate stories for tickets already planned?

Ticket intake prevents duplicate intake by checking configured ticket systems against existing state. It avoids re-ingesting tickets already present in state.yaml, ensuring each external ticket maps to a single story without duplication.

What's the best way to automate external ticket intake without manually drafting stories?

Automated ticket intake fetches external ticket content, determines APED placement through epic bucket matching or interactive selection, and writes the story artefact to the correct location while updating state.yaml with optional comment-back to the source ticket.

Do I need authentication configured to pull tickets from ClickUp or Linear?

Yes, provider-specific authentication and tooling checks are required. Ticket intake requires ticket_system to not be none and performs strict argument parsing by ticket system to validate access before fetching content and writing the story.

Why does ticket intake require user validation before writing the story?

User validation gates the story writing and state.yaml update to ensure safe handoff. Ticket intake fetches content, drafts the story, and requires explicit validation before writing the artefact and registering it, preventing automatic development execution.