Imported from whawkinsiv/solo-founder-skills (skills/support/SKILL.md). Install upstream with npx skills add whawkinsiv/solo-founder-skills --skill support. Copyright stays with the author.

Customer Support & Documentation

The best support interaction is the one that never happens. This skill helps you build self-serve documentation that eliminates tickets, set up efficient support workflows, and scale from 10 to 10,000 customers without a support team.

Core Principles

The best support interaction is the one that never happens. Invest in self-serve before staffing.
Documentation is not a chore — it's the highest-leverage support tool you have. One good help article prevents thousands of tickets.
Support is research. Every ticket reveals a product flaw, a UX failure, or a documentation gap. Track and fix the root cause, not just the symptom.
Tone matters more than speed. A warm, helpful reply in 4 hours beats a robotic auto-response in 4 seconds.
A solo founder can support 500+ customers if the product, docs, and onboarding are good. If support is crushing you at 50 customers, the product has problems.

Minimal Support Setup

What You Need at Launch

Tier 1: Absolute minimum (launch day)

Contact email (support@yourdomain.com) routed to your inbox
5-10 FAQ entries on a /help or /faq page
In-app "need help?" link that opens email compose

Tier 2: First 100 users

Help center with 15-25 articles covering common questions
Canned responses for the 5 most common questions
Simple ticket tracking (even a spreadsheet or Notion board works)

Tier 3: 100-500 users

Dedicated help center tool (Intercom, Crisp, HelpScout, or Plain)
In-app chat widget (live during business hours, async otherwise)
Knowledge base with search
Response time target: <4 hours during business hours

Tier 4: 500+ users

All of above + automated responses for common issues
Status page for incidents
Community forum or Discord for peer-to-peer support
Consider first support hire (or contractor)

Tool Recommendations by Stage

$0/mo:       Email + Notion/Google Docs help page
$0-50/mo:    Crisp (free tier) or Tawk.to (free)
$50-100/mo:  HelpScout Starter or Intercom Starter
$100-300/mo: Intercom or Plain (for developer tools)

Help Center Architecture

Information Structure

Organize by user journey, not by feature:

Getting Started
  ├── Creating your account
  ├── Setting up your first [core object]
  ├── Inviting team members
  └── Connecting your data source

Core Features
  ├── [Feature 1]: How to [outcome]
  ├── [Feature 2]: How to [outcome]
  ├── [Feature 3]: How to [outcome]
  └── Working with [key concept]

Account & Billing
  ├── Changing your plan
  ├── Updating payment method
  ├── Understanding your invoice
  ├── Canceling your account
  └── Exporting your data

Integrations
  ├── Connecting [Integration 1]
  ├── Connecting [Integration 2]
  └── API documentation

Troubleshooting
  ├── [Common error 1]: How to fix it
  ├── [Common error 2]: How to fix it
  └── Something else not working?

Writing Help Articles

Structure for every help article:

# [Task the user is trying to accomplish]

[One sentence: what this article helps you do.]

## Before you start
[Prerequisites — what the user needs before following these steps.]

## Steps

1. [Action verb] [specific instruction].
   - [Sub-detail if needed.]
   - [Screenshot or note if helpful.]

2. [Next action verb] [specific instruction].

3. [Continue until task is complete.]

## What to expect
[What happens after they complete the steps. What they should see.]

## Common issues

**[Issue 1]**
[Cause and fix in 1-2 sentences.]

**[Issue 2]**
[Cause and fix in 1-2 sentences.]

## Related articles
- [Link to related topic 1]
- [Link to related topic 2]

Writing rules:

Title = the task, not the feature. "How to invite team members" not "Team Management."
One article per task. Don't combine "setting up billing AND inviting users."
Use screenshots only when the UI is non-obvious. Don't screenshot every click.
Write for the user who is mildly frustrated and in a hurry.
Test every article by following the steps yourself on a fresh account.
Keep articles under 500 words. If longer, split into multiple articles.

FAQ Page

Write FAQ entries for these universal SaaS questions:

Getting Started:
  - How do I sign up?
  - Is there a free plan / trial?
  - How long does setup take?

Product:
  - What does [Product] do?
  - Who is [Product] for?
  - What integrations do you support?
  - Can I import my data from [competitor]?

Pricing & Billing:
  - How much does it cost?
  - Can I change plans?
  - Can I cancel anytime?
  - Do you offer refunds?
  - Is there a discount for annual billing?

Security & Data:
  - Is my data secure?
  - Where is my data stored?
  - Can I export my data?
  - What happens to my data if I cancel?

Support:
  - How do I get help?
  - What are your support hours?
  - How fast do you respond?

Support Response Templates

Canned Responses (customize, don't copy-paste robotically)

Acknowledgment (use when you need time to investigate):

Hi [Name],

Thanks for reaching out — I can see the issue and I'm looking into
it now. I'll get back to you within [timeframe] with an update.

[Your name]

Bug confirmed:

Hi [Name],

You're right — this is a bug on our end. I've identified the cause
and I'm working on a fix. I expect to have it resolved by [timeframe].

I'll email you as soon as it's deployed. Sorry for the trouble,
and thank you for catching this.

[Your name]

Feature request (saying no):

Hi [Name],

Thanks for the suggestion — I can see how [feature] would help
with [their specific use case].

Right now I'm focused on [what you're prioritizing and why], but
I've logged this and I'll revisit it when we get to [relevant area].
In the meantime, here's a workaround that might help: [workaround].

Appreciate the feedback — it genuinely shapes where the product goes.

[Your name]

Churn response (someone cancels):

Hi [Name],

Thanks for letting me know. I'm sorry [Product] didn't work out.

If you're comfortable sharing, I'd really appreciate knowing what
prompted the switch — even a one-line answer helps me make the
product better for others.

Either way, your data will be available for [X] days if you change
your mind. Thanks for giving us a try.

[Your name]

Confused user (unclear how to do something):

Hi [Name],

Great question — here's how to [do the thing]:

[2-4 numbered steps]

I've also added this to our help docs so it's easier to find next
time: [link].

Let me know if you run into anything else.

[Your name]

Reducing Support Load

The Support Reduction Loop

1. Track ticket topics (tag every ticket by category).
2. Find the top 5 topics by volume.
3. For each:
   a. Can the product fix it? → File bug/UX improvement → fix it.
   b. Can docs prevent it? → Write or improve the help article.
   c. Can onboarding prevent it? → Add tooltip, empty state copy, or setup step.
   d. Can an automated response handle it? → Create auto-reply or chatbot flow.
4. Repeat monthly.

Ticket Tracking Template

| Date | User | Category | Summary | Root Cause | Action Taken | Preventable? | Prevention Action |

Common categories:

How do I...? (documentation gap)
This doesn't work (bug)
I expected X but got Y (UX confusion)
Can you add...? (feature request)
Billing question (pricing/plan confusion)
Can't log in (auth issue)

In-App Self-Service

Reduce tickets by building these into the product:

Contextual help links: "Need help with this? [link to specific article]" next to complex features.
Empty state guidance: Every empty screen tells the user what to do and why.
Inline error messages: Explain what went wrong and how to fix it (see Copywriting skill).
Onboarding checklist: Prevents "I signed up but don't know what to do" tickets.
Status indicators: Show system status in-app so users don't email asking "is it down?"
Changelog / what's new: Prevents "when did this change?" confusion.

Support Metrics

Track monthly:

| Metric                      | This Month | Last Month | Target   |
|-----------------------------|------------|------------|----------|
| Total tickets               |            |            | Trending↓|
| Avg first response time     |            |            | <4 hours |
| Avg resolution time         |            |            | <24 hours|
| Tickets per 100 users       |            |            | <10      |
| Top ticket category         |            |            |          |
| % resolved by docs (no reply)|           |            | >30%     |
| CSAT (if measured)          |            |            | >4.5/5   |

The key ratio: Tickets per 100 users. If this is rising, your product is getting harder to use. If it's falling, your docs and UX improvements are working.

Related Skills

community — Build a community that supplements support
feedback — Turn support tickets into product improvement insights
copywriting — Write clear help articles and canned responses
retention — Support quality directly impacts churn

support

About