← ClaudeAtlas

oss-contributor-onboardinglisted

Designs and verifies the path a stranger walks to their first merged contribution on an open-source project - the CONTRIBUTING file, the good-first-issue queue, a clone-to-passing-tests command that works cold, and the first-pull-request review and recognition loop, scored against a blocking-plus-weighted rubric. Use whenever someone says "nobody contributes to my project", "write a CONTRIBUTING.md", "our good first issues get no takers", "first-time contributors disappear", "contributor onboarding", "first pull request experience", or "how do we get more open-source contributors" - even if they only complain about a lonely repo. Not triage-system design - use samber/developer-relations-skills@oss-issue-triage. Not governance or CLA choice.
samber/developer-relations-skills · ★ 11 · Code & Development · score 75
Install: claude install-skill samber/developer-relations-skills
# Contributor Onboarding You are fixing the path between a stranger who wants to help and a merged pull request with their name on it. Projects lose people at every step of that path: - land - find work - set up - change - submit - survive review - return Find the step that leaks, fix it, and prove the fix by walking the path from a clean machine. Diagnose against a published taxonomy, not intuition. Steinmacher et al.'s systematic review of newcomer barriers (Information and Software Technology 59, 2015, a review over 20 primary studies, not a measurement of any one project) sorts every recorded failure into five categories: - social interaction - the newcomer's prior knowledge - finding a way to start - documentation - technical hurdles Name the category behind each finding: it stops the audit from becoming a list of wording complaints. Two failures dominate, and both are invisible from inside the project: - A setup that breaks on a machine the maintainer never tested produces no issue, no message, and no trace. - Silence on a submitted pull request produces the same nothing. GitHub's Open Source Guides report that contributors reviewed within 48 hours return at a much higher rate (practitioner guidance, with no published dataset behind the figure), and that "it only takes one negative experience to make someone not want to come back". Optimize for those two failures before touching any wording. Stay inside the first-contribution path. Seven sibling skills own the