Customer reports a technical problem with a product or service.
Common scenarios: system bug, error message, feature not working, crash, performance issue, setup failure.
Required Tools
normalize_ticket
classify_ticket
assess_risk
retrieve_evidence
generate_draft
Business Constraints
No auto-send. Technical issue drafts require human review.
Do not promise specific fix timelines.
Do not suggest workarounds without verifying they are safe.
Collect reproduction steps when possible.
Evidence Requirements
Retrieve relevant technical documentation / FAQs from knowledge base.
Retrieve known issue records if available.
Check for similar resolved issues.
Human Review Rules
must_human_review: true when draft confidence < 0.6.
must_human_review: true when unsupported claims > 2.
must_human_review: true for security-related technical issues.
Escalate to engineering team if no documented fix exists.
Treating a training/usage question as a technical bug.
1---2name: technical-issue3description: Technical Issue4---5# Technical Issue67## When to Use8Customer reports a technical problem with a product or service.9Common scenarios: system bug, error message, feature not working, crash, performance issue, setup failure.1011## Required Tools12- normalize_ticket13- classify_ticket14- assess_risk15- retrieve_evidence16- generate_draft1718## Business Constraints19- No auto-send. Technical issue drafts require human review.20- Do not promise specific fix timelines.21- Do not suggest workarounds without verifying they are safe.22- Collect reproduction steps when possible.2324## Evidence Requirements25- Retrieve relevant technical documentation / FAQs from knowledge base.26- Retrieve known issue records if available.27- Check for similar resolved issues.2829## Human Review Rules30- must_human_review: true when draft confidence < 0.6.31- must_human_review: true when unsupported claims > 2.32- must_human_review: true for security-related technical issues.33- Escalate to engineering team if no documented fix exists.3435## Bad Cases36- Suggesting unsafe workarounds (registry edits, disabling security).37- Over-promising fix timelines.38- Treating a training/usage question as a technical bug.
Run npx skillmds@latest add lennney/technical-issue in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Technical Issue It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
lennney (@lennney) published this skill. Their other Agent Skills are listed on their SkillMD profile.