PlugWiki

oss-contributor-onboarding skill (samber): audit and fix the path to a first merged pull request

Audits and fixes the path from a stranger's first look to a first merged pull request, and drafts the CONTRIBUTING file.

Installs
12.7K
on skills.sh
Stars
7
on GitHub
Files
6
besides SKILL.md
Updated
Nov 2026
last repo commit

oss-contributor-onboarding makes your agent find the step where newcomers drop out and fix it. It runs a bundled audit script, cold-runs your setup from a clean state, stocks a first-issue queue, drafts CONTRIBUTING, and designs the review and recognition loop. Then it re-scores the path.

It triggers on "nobody contributes to my project", "write a CONTRIBUTING.md", "our good first issues get no takers" or first-time contributors disappearing. It bundles scripts/contributor-path-audit.sh, which needs bash and git. It expects to read and run commands in your repository.

Good for

  • Maintainers who say "nobody contributes to my project"
  • Projects whose good first issues sit untouched
  • Maintainers writing a CONTRIBUTING.md that must actually work

Install oss-contributor-onboarding

Claude Code

  1. 1

    Copy this prompt.

    Install the oss-contributor-onboarding skill in Claude Code. Run this command:
    
    /plugin marketplace add samber/developer-relations-skills
    /plugin install developer-relations-skills@developer-relations-skills
    
    Then check that it loaded and tell me how to use it.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

The README recommends installing the whole collection because its skills reference each other, and oss-contributor-onboarding names other skills in the collection to hand work to. The whole-collection routes add all 93 skills in the repo (counted from the git tree); the repo holds no hooks, agents, commands or MCP server files, and 14 of its skills bundle a script. This skill runs a bundled shell script (scripts/contributor-path-audit.sh), so it needs bash and git or standard shell tools on your machine. Pick one route per agent.

From the project README. Source.

What's in the skill

When it loads

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.

Sections in SKILL.md

  1. Invocation and output
  2. Interview
  3. Step 1 - Baseline before changing anything
  4. Step 2 - Walk the path yourself
  5. Step 3 - Fix the environment before the prose
  6. Step 4 - Stock the first-issue queue
  7. Step 5 - Write the CONTRIBUTING file
  8. Step 6 - Design the review and recognition loop
  9. Step 7 - Decide against the shortcuts before spending on them
  10. Step 8 - Re-score, then hold the target
  11. What to track afterwards
  12. Common failure modes
  13. Reference

Key facts

Installs on skills.sh
12,662 (as of Nov 2, 2026)
Version in SKILL.md
1.0.2

What it includes

  • Asks twelve questions one at a time; questions 1 to 7 gate the work.

    Questions 4 to 6 (hours per week, deadline, one wave or lasting path) re-rank the fixes and can delete the structured program.

    Interview

  • Prints mechanical facts about the first-contribution path.

    Community-health files and their precedence, a keyword probe of CONTRIBUTING for ten topics, setup files and lockfiles, workflows using secrets or pull_request_target, and git history (authors, one-commit-only rate, absence factor, new authors per year). It writes a temporary author-email file in /tmp and deletes it at the end.

    Runs code · scripts/contributor-path-audit.sh <repo-root>

  • Runs a cold run of the written steps from a clean state and keeps a friction log.

    The scorecard reference says to use a fresh container, a new user account or a machine that never built the project, run the written steps literally, and rerun until nothing new appears.

    Runs code · Step 2 - Walk the path yourself

  • Picks a reproducibility tier: bootstrap command, pinned toolchain or container definition.

    It also asks for every CI gate to be runnable locally and a credential-free lane for fork pull requests.

    Write · Step 3 - Fix the environment first

  • Rewrites candidate issues with seven parts, including a verify command and a mentor.

    It sizes each issue at roughly one evening and keeps at least three unclaimed valid issues.

    Step 4 - Stock the first-issue queue

  • Drafts the file section by section and keeps one copy where the forge shows it.

    Every command in the file must be one it ran in step 2 or 3.

    Write · Step 5 - Write CONTRIBUTING

  • Designs eight habits, including acknowledging on a separate clock from reviewing.

    Scope answered in the first comment, a fixed review order, blocking versus optional labels, a fast kind decline, credit at merge and an invitation to the second contribution.

    Step 6 - Review and recognition loop

  • Decides on a bot, a structured program or an onboarding event, then re-scores.

    Pass means all four blocking checks and 12 of 16 scored points. The re-check repeats quarterly, installed as a recurring task if the environment supports scheduled routines.

    Step 7 and 8 - Shortcuts, then re-score

From the official docs

Permissions

Medium risk

The agent runs a bundled shell script and your project's setup commands, and it can edit files in your repository. Use a container for the cold run and review every file it drafts before you commit.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • It runs your project's setup and test commands

    The cold run follows your README and CONTRIBUTING literally in a clean environment and records failures. Our advice: use a container or a new user account and read each command before it runs. github.com

  • The audit script touches /tmp and reads author emails

    The script writes commit author emails to a temporary file named .cpa_authors.<pid> in /tmp and removes it with rm -f at the end. It prints counts, not the emails. github.com

  • It can install a recurring re-check

    Step 8 says to install the quarterly re-check as a recurring task where the environment supports scheduled routines. Our advice: say no if you do not want a scheduled job. github.com

  • The Claude app route is left out of the install box

    The skill reads and runs things in a repository on your machine, so the install box has no Claude app upload tab for it. github.com

  • It may keep notes in devrel-context.md

    SKILL.md tells the agent to store a few details about the current task or project, and to use a file called devrel-context.md when its memory lives in a file. Our advice: open that file before you commit or share the folder. github.com

  • The plugin route installs the whole collection

    The README's plugin and extension routes add every skill in the repo; its git tree holds 93. The repo has no hooks, agents, commands or MCP server files, and 14 of its skills bundle a script. Our advice: use the skills CLI command for this skill if you want only it. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details
Turning on read-onlySKILL.md describes no read-only mode.
Scopes
  • Runs scripts/contributor-path-audit.sh in your repository (reads git log and workflow files)

  • Cold run: executes the written setup and test steps from a clean state

  • Drafts or edits CONTRIBUTING and setup files in your repository

Questions

How do I install oss-contributor-onboarding?

The README says to install every skill in the collection, because its skills reference each other. In Claude Code that is the plugin route in the install box above, which adds all 93 skills in the repo. The skills CLI can add just this one. Our advice: pick one route per agent. The audit script needs bash and git.

What do I get at the end?

A scored audit of the contributor path, a drafted CONTRIBUTING file with commands proven by a cold run, a rewritten first-issue queue with a claiming convention and expiry rule, a review playbook and a re-check cadence.

What does the script do?

contributor-path-audit.sh prints facts about your repository: community-health files, a keyword probe of CONTRIBUTING, setup files, CI workflows using secrets, and contributor history from git log. SKILL.md says it reports facts, not judgements, and its keyword probe is a vocabulary check, not a coverage check.

oss-contributor-onboarding vs oss-issue-triage?

Use this skill for the stranger's path to a first merged pull request, and oss-issue-triage for the maintainers' triage system. SKILL.md says "Not triage-system design", and the README describes the other skill as a triage system maintainers can sustain.

Does it work without running commands?

Partly. The scorecard reference says that if the agent cannot execute commands it should say so and ask the maintainer to run the sequence and paste the output, and it will not mark the setup check passed by inspection.

Does oss-contributor-onboarding need an API key, and where does it work?

SKILL.md names no API key, account or environment variable. The README documents installs for Claude Code, Claude.ai (add the repo as a plugin marketplace), Codex, Cursor, Gemini CLI and any Agent Skills-compatible tool through the skills CLI. This skill reads and runs things in your repository, so the install box has no Claude app upload tab for it. Our advice: use Claude Code or Codex.

Is oss-contributor-onboarding safe to install?

The folder bundles one shell script, contributor-path-audit.sh, and the cold run executes the setup steps from your README and CONTRIBUTING in a clean environment. The script reads git history, including author emails, and keeps them in a temporary file in /tmp that it deletes at the end. Our advice: run the cold run in a container, read the script first, and check any file the agent drafts before you commit it.

Information

updated Nov 2, 2026

Folder
skills/oss-contributor-onboarding

samber/developer-relations-skillsskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 4
  1. developer-relations-skills README · github.com
  2. oss-contributor-onboarding SKILL.md · github.com
  3. contributor-path-scorecard.md (cold-run protocol) · github.com
  4. contributor-path-audit.sh · github.com

Updated Nov 2, 2026.