FrancoStino/community-building

Community Building

When to Use

Use this skill when you need when the user wants to build, grow, or improve a developer community on Discord, Slack, or forums. Trigger phrases include "developer community," "Discord server," "Slack community," "community strategy," "community engagement," "community moderation," "community growth," or "community...

This skill helps you build and manage developer communities on Discord, Slack, forums, and other platforms. Covers channel structure, onboarding, engagement programs, handling toxicity, and community-led growth.

---

Before You Start

Load your audience context first. Read .agents/developer-audience-context.md to understand:

• Who your developers are (role, seniority, interests)
• Where they already hang out (to avoid competing platforms)
• What problems they discuss (community topic focus)
• How they communicate (formal vs. casual tone)

If the context file doesn't exist, run the developer-audience-context skill first.

---

Platform Selection

Comparison Matrix

| Platform | Best For | Pros | Cons | |----------|----------|------|------| | Discord | Developer tools, gaming, OSS | Real-time, rich features, free | Can be chaotic, less enterprise | | Slack | Enterprise, B2B SaaS | Professional, familiar | Expensive at scale, message limits | | GitHub Discussions | OSS projects | Integrated, async, searchable | Less community feel | | Discourse | Long-form, searchable | SEO, threading, ownership | Maintenance, hosting costs | | Circle | Courses, paid communities | Courses integration, clean | Paid, less developer-native |

Decision Framework

| If your audience is... | Consider | |------------------------|----------| | Individual developers, OSS | Discord | | Enterprise teams | Slack | | Technical, async-preferred | GitHub Discussions | | Mixed, need searchability | Discourse | | Course/education based | Circle |

---

Channel Structure

Discord Channel Template

📢 INFORMATION
├── #welcome — First landing, rules, links
├── #announcements — Official updates (admin-only posting)
├── #rules — Code of conduct
└── #introductions — New member intros

💬 GENERAL
├── #general — Main discussion
├── #off-topic — Non-project chat
└── #show-what-you-built — Share projects

❓ SUPPORT
├── #help — General questions
├── #troubleshooting — Bug help
└── #feature-requests — Suggestions

🔧 TECHNICAL
├── #backend — Backend discussions
├── #frontend — Frontend discussions
└── #devops — Infrastructure discussions

🤝 COMMUNITY
├── #jobs — Job postings (if allowed)
├── #events — Meetups, conferences
└── #content — Blog posts, videos

📚 RESOURCES
├── #learning — Tutorials, courses
└── #tools — Useful tools and libraries

Slack Channel Template

# welcome
# announcements (admin-only)
# general
# help
# random (off-topic)
# jobs (optional)
# introductions
# feedback

Channel Guidelines

| Channel Type | Posting Rules | Moderation Level | |--------------|---------------|------------------| | Announcements | Admin only | N/A | | General | On-topic discussion | Light | | Help | Questions welcome, be patient | Medium | | Off-topic | Anything goes (within CoC) | Light | | Jobs | Structured format required | Heavy | | Introductions | One post per person | Light |

---

Onboarding Experience

New Member Journey

Join Server
    ↓
Welcome Message (DM or public)
    ↓
Read Rules / Accept
    ↓
Verify (optional: GitHub, email)
    ↓
Introduce Yourself
    ↓
First Interaction
    ↓
Regular Member

Welcome Message Template

Discord DM:

Welcome to [Community Name]! 👋

Here's how to get started:

1. Read the rules in #rules
2. Introduce yourself in #introductions
3. Ask questions in #help — we're friendly!

Quick links:
• Documentation: [link]
• Getting started: [link]
• GitHub: [link]

We're glad you're here!

Public #welcome channel:

# Welcome to [Community Name]!

We're [brief description of who you are and what you do].

## Quick Start

1. **Read the rules** → #rules
2. **Introduce yourself** → #introductions
3. **Get help** → #help
4. **Chat with us** → #general

## Useful Links

- [Documentation]
- [GitHub]
- [Website]

## Questions?

Drop a message in #help or mention @moderators

Role Assignment

| Role | How to Get | Permissions | |------|------------|-------------| | New Member | Auto on join | Limited channels | | Member | Verify or time-based | Full access | | Contributor | PR merged, active helper | Badge, special channel | | Moderator | Invited | Moderation powers | | Admin | Core team | Full access |

---

Engagement Programs

Discussion Prompts

Schedule regular engagement:

| Day | Prompt Type | Example | |-----|-------------|---------| | Monday | This week's goals | "What are you working on this week?" | | Wednesday | Technical question | "Controversial: Tabs or spaces?" | | Friday | Show & Tell | "Share what you shipped this week" |

Recognition Programs

| Program | Description | Frequency | |---------|-------------|-----------| | Contributor of the Month | Recognize top helpers | Monthly | | First PR Celebration | Welcome new contributors | As happens | | Milestone Badges | 10/50/100 messages | Automatic | | Expert Roles | Domain expertise recognition | Quarterly |

Event Ideas

| Event Type | Format | Effort | |------------|--------|--------| | Office Hours | Live Q&A with team | Low | | Show & Tell | Members demo projects | Low | | Workshops | Teaching sessions | Medium | | Hackathons | Build challenges | High | | Game Night | Non-tech fun | Low | | AMA Sessions | Guest experts | Medium |

Engagement Metrics

| Metric | What It Tells You | |--------|------------------| | DAU/MAU | Daily vs monthly active users | | Messages per user | Individual engagement depth | | Questions answered | Community self-sufficiency | | New member retention | Onboarding effectiveness | | Event attendance | Program resonance |

---

Handling Toxicity

Code of Conduct Essentials

# Code of Conduct

## Our Standards

**Do:**
- Be respectful and inclusive
- Help others learn (no "RTFM")
- Assume good intentions
- Give constructive feedback
- Report problems, don't engage

**Don't:**
- Personal attacks or harassment
- Discrimination of any kind
- Spam or self-promotion
- NSFW content
- Doxxing or privacy violations
- Bad faith arguments

## Enforcement

1. **Warning** — First offense, good faith
2. **Temp mute** — Repeated issues
3. **Temp ban** — Serious violations
4. **Permanent ban** — Egregious or repeated

## Reporting

DM any @moderator or use the report feature.
All reports are confidential.

Moderation Playbook

| Situation | Response | |-----------|----------| | Heated debate | "Let's keep this constructive. Both perspectives have merit." | | Help vampire | "Here's a guide on asking good questions: [link]" | | Self-promotion spam | Delete, warn, or ban depending on frequency | | Off-topic drift | "Great discussion! Let's move this to #off-topic" | | Harassment | Immediate mute, investigate, likely ban | | Bad faith troll | Don't engage publicly, ban quietly |

De-escalation Techniques

1. Acknowledge feelings — "I can see this is frustrating"
2. Move to DM — "Let's continue this privately"
3. Take a break — "Let's pause and revisit tomorrow"
4. Clarify intent — "I think there might be a misunderstanding"
5. Set boundaries — "We're here to help, but not to be yelled at"

Moderator Self-Care

| Risk | Mitigation | |------|------------| | Burnout | Rotate moderator duties | | Taking it personally | Remember: it's not about you | | Imposter syndrome | Regular team check-ins | | Isolation | Moderator private channel |

---

Community-Led Growth

Word-of-Mouth Tactics

| Tactic | How | |--------|-----| | Referral program | Rewards for invites that stick | | Share-worthy content | Exclusive insights, early access | | Member spotlights | Feature members → they share | | Success stories | "I got a job through this community" |

User-Generated Content

| Content Type | How to Encourage | |--------------|------------------| | Tutorials | "Share your setup in #show-what-you-built" | | Q&A threads | Reward helpful answers | | Project showcases | Monthly demo events | | Testimonials | Ask happy members |

Community Champions

Identify and empower super-users:

| Champion Type | Role | |---------------|------| | Greeters | Welcome new members | | Helpers | Answer support questions | | Content creators | Tutorials, videos, guides | | Event organizers | Run community events | | Connectors | Introduce people to each other |

---

Community Metrics

Health Dashboard

| Metric | Healthy | Warning | Action Needed | |--------|---------|---------|---------------| | Response time (support) | <24h | 24-72h | >72h | | Unanswered questions | <10% | 10-25% | >25% | | New member 7-day retention | >40% | 20-40% | <20% | | Monthly active ratio | >20% | 10-20% | <10% | | Moderator messages ratio | <30% | 30-50% | >50% |

Growth Metrics

| Metric | How to Track | |--------|-------------| | Total members | Platform analytics | | Join rate | New members per week | | Churn rate | Leaves per month | | Engagement depth | Messages per active user | | Support success | % questions resolved |

---

Automation

Useful Bots (Discord)

| Bot | Purpose | |-----|---------| | MEE6 / Carl-bot | Moderation, welcome messages, roles | | Statbot | Analytics and metrics | | Ticket Tool | Support ticket system | | GitHub Bot | Repo activity notifications | | YAGPDB | Advanced moderation, custom commands |

Automation Ideas

| Automation | Benefit | |------------|---------| | Welcome DM | Consistent onboarding | | Auto-role on join | Immediate access | | Inactive member ping | Re-engagement | | Support ticket creation | Organized help | | GitHub notifications | Keep community informed | | Scheduled posts | Regular engagement |

---

Tools

| Tool | Use Case | |------|----------| | Octolens | Monitor community mentions across GitHub, Twitter, Reddit. Find where your community members talk about you. Track sentiment. Discover community content to amplify. | | Commsor | Community operations platform | | Notion | Community wiki and resources | | Luma | Event management | | StreamYard/Restream | Live event streaming |

---

Related Skills

• developer-audience-context — Know your community members
• open-source-marketing — OSS community building
• developer-advocacy — Personal brand in community
• developer-newsletter — Community digest content

Limitations

• Use this skill only when the task clearly matches its upstream source and local project context.
• Verify commands, generated code, dependencies, credentials, and external service behavior before applying changes.
• Do not treat examples as a substitute for environment-specific tests, security review, or user approval for destructive or costly actions.