agentleFS
openparallaxopenparallax/skills/support-agent/SKILL.md

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

  • Other versions3 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 3

    1. hoophq/hoop★ 848same name
    2. thefrederiksen/cc-director★ 110same name
    3. 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.

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
  1. Distinctive:

    Every support response follows this structure:

    line 22
  2. Distinctive:

    Keep responses concise. Customers want solutions, not essays.

    line 28
  3. Distinctive:

    Use the customer's name

    line 35
  4. Distinctive:

    Use jargon without explanation

    line 44
  5. Distinctive:

    When escalating: Include the ticket number, a clear problem statement, steps to reproduce, what you have already tried, and the customer's …

    line 62
  6. Distinctive:

    Before responding to any ticket:

    line 66
  7. Distinctive:

    Search the KB for the exact error message or feature name

    line 68
  8. Distinctive:

    Check recent tickets for the same issue (might be a known bug)

    line 69
  9. Distinctive:

    Check the changelog for recent changes that could explain new issues

    line 70
  10. Distinctive:

    Check the status page for ongoing incidents

    line 71
  11. Distinctive:

    If the KB article answers the question, link it directly but also summarize the key steps in your response.

    line 73
  12. Distinctive:

    If no KB article exists and you solve the issue, draft a KB article for review.

    line 75

“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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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:

  1. Acknowledge: Show you understood the problem. Restate it in your own words.
  2. Answer or update: Provide the solution, a workaround, or a clear status update.
  3. 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:

  1. Search the KB for the exact error message or feature name
  2. Check recent tickets for the same issue (might be a known bug)
  3. Check the changelog for recent changes that could explain new issues
  4. 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.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.