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
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
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
- Invocation and output
- Interview
- Step 1 - Baseline before changing anything
- Step 2 - Walk the path yourself
- Step 3 - Fix the environment before the prose
- Step 4 - Stock the first-issue queue
- Step 5 - Write the CONTRIBUTING file
- Step 6 - Design the review and recognition loop
- Step 7 - Decide against the shortcuts before spending on them
- Step 8 - Re-score, then hold the target
- What to track afterwards
- Common failure modes
- Reference
Key facts
- Author
- Samuel Berthe (samber)
- Installs on skills.sh
- 12,662 (as of Nov 2, 2026)
- GitHub stars
- 8 for the whole collection repo (Nov 2, 2026)
- Last commit
- Nov 1, 2026 (whole repo)
- skills.sh audits
- Gen Agent Trust Hub pass, Socket pass, Snyk pass
- What is inside
- 7 files including SKILL.md: 4 reference files, 1 script (contributor-path-audit.sh) and evals/evals.json
- Version in SKILL.md
- 1.0.2
- Collection size
- 93 skills in the repo (counted from the git tree)
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.
InterviewPrints 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 yourselfPicks 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 firstRewrites 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 queueDrafts 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 CONTRIBUTINGDesigns 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 loopDecides 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-only | SKILL.md describes no read-only mode. |
|---|---|
| Scopes |
|
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
- Repository
- samber/developer-relations-skills
- Folder
skills/oss-contributor-onboarding
Sources
Docs, issue trackers and discussions this page is built from.
Show all 4Hide
- developer-relations-skills README · github.com
- oss-contributor-onboarding SKILL.md · github.com
- contributor-path-scorecard.md (cold-run protocol) · github.com
- contributor-path-audit.sh · github.com