Skip to content
cccskills
FreePublished on GitHub

rseng-contributor-onboarding

Covers turning users into contributors and contributors into regulars: curating genuinely good first issues, onboarding paths and checklists generated from the repository, first-PR shepherding, mentorship and buddy structures, and measuring where the contribution funnel leaks. Use when a project wants contributors but gets none, when first-time contributors do not return, when the user asks for good-first-issue curation, onboarding documentation or mentorship structure, or when a team member or student is joining a research software project.

The English summary is being prepared. Showing the original description.

fdiblen/rseng-agent-skills24 stars(GitHub 24 + cccskills 0)

Run score Not tested

See how to install

Files included (2)

  • SKILL.md5.1 KB
  • references.md426 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

Contributor onboarding

Contributors are made, not found: someone used the software, hit an edge, and the project either made the path from "I could fix this" to a merged PR walkable - or it did not. Onboarding is engineering that path deliberately, for external contributors and equally for the new student or teammate joining the project (the same path, walked faster). The funnel framing keeps it honest: user -> first contact -> first contribution -> second contribution -> regular; each transition can be measured (rseng-community-metrics) and fixed.

Good first issues: curation, not labeling

A good first issue is a real, wanted task that is genuinely doable without tribal knowledge - and the label is a promise:

  • Curate each one: state the problem, point at the relevant files, sketch the approach, name the definition of done and the test to add (rseng-testing) - fifteen minutes of curation per issue, repaid by every newcomer it serves. An agent can draft these from the backlog well (rseng-project-tracking).
  • Keep the shelf stocked and fresh: a handful available, claimed ones released after inactivity, solved ones replaced - an empty or stale good-first-issue shelf tells newcomers the invitation was decoration (directories like goodfirstissue.dev index the label; being indexed with stale issues hurts).
  • Non-code first issues count: docs gaps, example datasets, FAQ entries (rseng-user-support's pipeline generates them naturally) - often the truest first contribution for research audiences.

The walkable path

  • The onboarding trail is testable: CONTRIBUTING.md's setup steps (rseng-community-governance) run cleanly from a fresh clone - verify it the clean-room way (rseng-reproducibility) and keep it verified in CI where feasible; a broken dev-setup step loses more contributors than any hard bug.
  • Generate the project-specific onboarding checklist from the repository: where things live (architecture notes - rseng-software-design's ADRs), how to run tests, how review works, who to ask what - the knowledge-transfer document that also cuts the bus factor (rseng-maintenance-sustainability). For team members, add accounts, data access (rseng-regulatory-compliance where sensitive) and the project glossary.
  • First-PR shepherding: respond fast (the retention predictor - rseng-community-metrics), review kindly with the first-contribution bar - correctness yes, style nits no (rseng-pair-programming's blocking-vs-preference split), and land it; a merged small PR beats a perfect stalled one. Credit immediately (rseng-citation-metadata's first-merged-PR trigger).
  • Mentorship structure, sized honestly: a named point of contact for a newcomer's first weeks beats a formal program a two-person team cannot staff; buddy pairing for cohorts (students, sprint attendees - rseng-trainer for the teaching craft). First-timer-friendly conventions (firsttimersonly.com collects them) set the tone.

Measure the funnel, fix the leak

Where do people stall? Issues claimed but never PRed (setup or scoping problem), PRs opened but abandoned (review latency or harsh feedback), first PRs merged but no second (no next step offered - suggest one at merge time). The funnel numbers (rseng-community-metrics) point at the stage; the fix is usually in this skill or rseng-user-support. Ask leavers when possible - one honest exit answer outweighs a dashboard.

Working with this skill

This skill is source-independent: it encodes contributor onboarding practice for research software. It is the funnel between rseng-user-support (users with questions) and rseng-community-governance (contributors with rights), measured by rseng-community-metrics.

Learn more (verified):

<!-- related-skills:begin -->

Related skills

Check whether any of these applies before moving on:

  • rseng-community-governance - rules and CONTRIBUTING newcomers follow
  • rseng-community-metrics - measures funnel conversion
  • rseng-pair-programming - kind first-PR review bar
  • rseng-reproducible-environments - fresh-clone dev setup must work
  • rseng-trainer - teaching cohorts and students
  • rseng-user-support - active answerers become contributors
<!-- related-skills:end -->

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Covers operating AI coding agents securely: auditing whether the agent runs sandboxed, permission and dangerous-command configuration, containerized environments, secrets kept out of context, network egress and token privileges, prompt-injection risk, and the privacy of agent use itself. Use PROACTIVELY when permission gating is broadly disabled (skip-permissions modes), when secrets are visible to the agent's shell, or when the agent processes untrusted code, issues or web content; when a project holds personal or confidential data while a cloud agent is active (what leaves the machine, retention, training use), or when the user asks how to run coding agents safely or privately. (Supply-chain security: rseng-security; disclosing agent contributions: rseng-ai-declaration.)

The English summary is being prepared. Showing the original description.

fdiblen/rseng-agent-skills24Updated Sep 23, 2026

Covers declaring AI involvement with the AI Declaration Format (https://ai-declaration.org): creating and maintaining an aidecl.yaml that records which AI tools and agents were used, what each contributed, when and how much, plus the README disclosure footnote, JSON/JSON-LD export and CI validation. Machine-readable disclosure is the practice; this format is one implementation. Use PROACTIVELY when an AI assistant or agent creates or modifies a project's content - generate aidecl.yaml if missing, update it after AI-assisted changes. Also use when the user asks about AI transparency, provenance, disclosure or EU AI Act disclosure, wants to state that NO AI was used, or mentions aidecl. For concealment requests see rseng-honesty; for the human review duty see rseng-human-verification.

The English summary is being prepared. Showing the original description.

fdiblen/rseng-agent-skills24Updated Sep 23, 2026

Covers long-term archiving of research software and data: Software Heritage save requests and SWHID persistent identifiers, Zenodo deposits with versioned DOIs and forge integration, choosing domain and institutional repositories, deciding what to archive (code, data, environments, documentation) and when, and archiving at project retirement. Use when the user wants software or data preserved beyond the life of a forge account, grant or lab, mentions Software Heritage, SWHIDs, Zenodo deposits or archiving, retires or hands over a project, prepares artifacts that must stay resolvable for a paper, or when funder policy requires long-term preservation. (Cutting the release itself is rseng-publishing-releasing; day-to-day data storage and repository choice is rseng-data-management.)

The English summary is being prepared. Showing the original description.

fdiblen/rseng-agent-skills24Updated Sep 23, 2026

Covers processing research data that outgrows one machine's memory: out-of-core and chunked computation, Dask for scaling the scientific Python stack, Spark for distributed tabular pipelines, lazy evaluation, partitioning strategies, idempotent and restartable batch jobs, and knowing when NOT to distribute. Use when datasets no longer fit in memory, when the user mentions Dask, Spark, out-of-core or larger-than-memory data, when a pandas/NumPy workflow hits memory limits, or when designing batch pipelines over many files. (Cluster job submission and job arrays are rseng-hpc-computing; pipeline orchestration engines are rseng-workflows; profile first with rseng-performance-profiling.)

The English summary is being prepared. Showing the original description.

fdiblen/rseng-agent-skills24Updated Sep 23, 2026

Covers continuous integration and delivery for research software: CI/CD concepts, automating builds and tests with GitHub Actions and GitLab CI/CD, and wiring an organization's GitLab CI infrastructure to a GitHub-hosted project. Use when the user asks to set up CI, write a pipeline or workflow file (.github/workflows, .gitlab-ci.yml), add automated builds/tests on push or pull request, publish a package or deploy docs when a tag or release is cut, cache dependencies to speed up CI runs, choose between GitHub Actions and GitLab CI, use self-hosted or GPU runners, mirror a repo, or report external CI status back to GitHub. For what to test and shrinking a test matrix see rseng-testing; for linter and pre-commit policy see rseng-code-quality.

The English summary is being prepared. Showing the original description.

fdiblen/rseng-agent-skills24Updated Sep 23, 2026

Covers verifying that every citation is real, correct and current: checking references in manuscripts, READMEs, references files and code metadata against Crossref and OpenAlex, screening cited DOIs against the Retraction Watch database, catching fabricated or mis-attributed citations (a documented AI failure mode), and keeping bibliographies and CITATION.cff files resolvable. Use PROACTIVELY before any bibliography, reference list or citation metadata is finalized or published, whenever the agent itself has produced citations, and when the user asks to check references, mentions broken DOIs, retracted papers or citation verification, or prepares a manuscript, README or software paper with references. (Making your own software citable is rseng-citation-metadata.)

The English summary is being prepared. Showing the original description.

fdiblen/rseng-agent-skills24Updated Sep 23, 2026

See all skills by fdiblen

Report a problem with this skill