issue-report-report-template

Assembles structured issue reports with severity levels and delivers them via LingTai email or chat channels.

692|60|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/Lingtai-AI/lingtai --skill issue-report-report-template
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issue-report-report-template
Source: https://github.com/Lingtai-AI/lingtai/tree/main/tui/internal/preset/skills/lingtai-issue-report/reference/report-template
Command: npx skills add https://github.com/Lingtai-AI/lingtai --skill issue-report-report-template

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When an agent encounters a bug in a skill, capability, or preset, it needs a consistent, evidence-backed way to document the problem and route it to the right people before any GitHub issue is filed. This reference provides the canonical report skeleton and delivery rules so reports are complete, durable, and correctly routed.

Core Features & Use Cases

  • Structured Report Skeleton: Defines a fixed subject line format and body sections — what's wrong, where, reproduction steps, expected vs actual behavior, severity (blocking/major/minor/cosmetic), and an optional suggested fix — that double as a GitHub-flavored Markdown issue body.
  • Channel-Aware Delivery: Instructs agents to send the report via LingTai internal email to the parent avatar and the human, or through the human's active chat channel such as Telegram, before any filing decision.
  • Repository Routing Guidance: Directs reports to the Lingtai-AI/lingtai umbrella issue tracker, with fallback guidance for kernel-specific issues and self-healing notes when the template itself is stale.
  • Use Case: An agent discovers a documented feature is broken, gathers reproduction evidence, fills in the template, and mails the structured report to its parent and the human for consent before filing on GitHub.

Quick Start

Load the issue report template and assemble a structured bug report with reproduction steps and severity, then send it to my parent avatar and me by email.

Frequently Asked Questions about issue-report-report-template

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

FAQPage Schema
How do I write a structured bug report for a LingTai skill?

Use the report template with a subject line prefixed [Issue Report], then fill in sections for what's wrong, where, reproduction steps, expected vs actual behavior, and severity. Keep the section headers verbatim so the body works directly as a GitHub Markdown issue.

How do I send an issue report through LingTai email?

Call the email tool with action send, the parent or human address, the [Issue Report] subject, and the structured body. Send the same content explicitly to both your parent avatar and the human, using whichever channel the human is actively on.

Which GitHub repository should LingTai issues be filed in?

File end-user reports in the Lingtai-AI/lingtai umbrella tracker, even if the underlying bug lives in lingtai-kernel or a sibling skill repo. Maintainers route or transfer issues as needed; kernel-specific reports may go to lingtai-kernel if the human prefers.

What severity levels does the issue report template support?

Four levels: blocking (workflow cannot complete), major (documented feature broken with a workaround), minor (incorrect detail that misleads but doesn't break workflows), and cosmetic (typos, formatting, broken links).

What should I do if the issue report template itself is outdated?

Include a note in your report stating what the template says versus what you actually found, such as broken GitHub URLs or missing sections. Maintainers use this self-healing feedback to update the skill.