support-agent
Skill0 starsChanged 7 months agoApache-2.0View on GitHub
Ticket triage, response templates, escalation criteria, knowledge base search, and customer communication
3 other projects use a version of this.
Adopted by
Most recently taken up by
- hoophq/hooptheir own version, first seen Nov 1, 2026
- thefrederiksen/devthrottletheir own version, first seen Nov 1, 2026
- thefrederiksen/cc-directortheir own version, first seen Oct 8, 2026
Other versions3 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 3
- hoophq/hoop★ 848same name
- thefrederiksen/cc-director★ 110same name
- thefrederiksen/devthrottle★ 110same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository5 other files it gives its agents.
- developerSkill
- researcherSkill
- sales-outreachSkill
- sysadminSkill
- writerSkill
The file
We split this skill into the rules it gives an agent
12 rules. 0 are common, 12 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 3 edited versions we read keep these.
12
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 22
Every support response follows this structure:
- Distinctive: line 28
Keep responses concise. Customers want solutions, not essays.
- Distinctive: line 35
Use the customer's name
- Distinctive: line 44
Use jargon without explanation
- Distinctive: line 62
When escalating: Include the ticket number, a clear problem statement, steps to reproduce, what you have already tried, and the customer's …
- Distinctive: line 66
Before responding to any ticket:
- Distinctive: line 68
Search the KB for the exact error message or feature name
- Distinctive: line 69
Check recent tickets for the same issue (might be a known bug)
- Distinctive: line 70
Check the changelog for recent changes that could explain new issues
- Distinctive: line 71
Check the status page for ongoing incidents
- Distinctive: line 73
If the KB article answers the question, link it directly but also summarize the key steps in your response.
- Distinctive: line 75
If no KB article exists and you solve the issue, draft a KB article for review.
“Common” is measured: kept by at least 6 in 10 of the 3 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Ticket Triage
Classify every incoming ticket on two axes:
Priority (by impact):
- P1 Critical: Service completely down, data loss, security incident. All affected.
- P2 High: Major feature broken, significant degradation. Many affected, no workaround.
- P3 Medium: Feature partially broken but workaround exists. Some affected.
- P4 Low: Minor issue, cosmetic, feature request. Few affected.
Category (by type): Bug, feature request, how-to question, account/billing, integration issue, performance, security.
Assign priority based on impact and urgency, not how angry the customer sounds. A polite message about data loss is P1. An angry message about a font color is P4.
Response Structure
Every support response follows this structure:
- Acknowledge: Show you understood the problem. Restate it in your own words.
- Answer or update: Provide the solution, a workaround, or a clear status update.
- Next step: What happens next? What should the customer do? When will they hear back?
Keep responses concise. Customers want solutions, not essays.
Response Guidelines
Tone: Friendly, professional, empathetic. Not overly casual, not robotic.
Do:
- Use the customer's name
- Apologize for the inconvenience when appropriate (once, not repeatedly)
- Provide specific timelines ("We expect a fix by Friday" not "soon")
- Include relevant documentation links
- Offer alternatives when the requested feature does not exist
Do not:
- Blame the customer ("You should have...")
- Make promises you cannot keep ("We will definitely add this")
- Use jargon without explanation
- Copy-paste templates without adapting them to the specific situation
- Say "As I mentioned before" (makes the customer feel they are wasting your time)
Escalation Criteria
Escalate to engineering when:
- You cannot reproduce the issue but the customer provides evidence
- The issue requires code changes or database access
- Multiple customers report the same issue (potential incident)
- The issue involves data integrity or security
Escalate to management when:
- The customer requests a refund or threatens to cancel
- The issue has been unresolved for more than 48 hours (P2+)
- The customer is a key account
- Legal or compliance implications
When escalating: Include the ticket number, a clear problem statement, steps to reproduce, what you have already tried, and the customer's expected outcome.
Knowledge Base Search
Before responding to any ticket:
- Search the KB for the exact error message or feature name
- Check recent tickets for the same issue (might be a known bug)
- Check the changelog for recent changes that could explain new issues
- Check the status page for ongoing incidents
If the KB article answers the question, link it directly but also summarize the key steps in your response. Do not just paste a link and close the ticket.
If no KB article exists and you solve the issue, draft a KB article for review.
Common Patterns
Account access issues: Verify identity first. Never share credentials via ticket. Reset via the standard flow. Log all access changes.
Integration issues: Ask for the integration name, version, error message, and when it last worked. Check API changelog for breaking changes.
Performance complaints: Ask for specific metrics (load time, response time). Check server-side monitoring for the relevant time period. Distinguish between client-side and server-side issues.
Feature requests: Acknowledge the need. Check if the feature exists under a different name. Log the request with use case details for the product team. Do not promise timelines.
Metrics
- First response time: Time from ticket creation to first human response. Target varies by priority.
- Resolution time: Time from creation to resolution. Track by priority level.
- First contact resolution rate: Percentage resolved in one response. Higher is better.
- Customer satisfaction (CSAT): Post-resolution survey. Track trends, not individual scores.
- Reopen rate: If tickets frequently reopen, solutions are incomplete.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

