Skip to content
cccskills
FreePublished on GitHub

rseng-community-governance

Covers building and governing a community around research software: CONTRIBUTING guides, codes of conduct, governance models and decision-making, contributor recognition policy, issue and discussion hygiene, and handing over or sharing maintainership. Use when a project wants external contributors, when the user asks for a CONTRIBUTING.md, code of conduct or governance document, when maintainer burnout or bus-factor risks come up, or when a project is moving from single-author to team or community ownership. The contributor funnel and good-first-issue curation live in rseng-contributor-onboarding; health measurement in rseng-community-metrics; support operations in rseng-user-support.

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.6 KB
  • references.md452 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

Community and governance for research software

Most research software dies with its author's contract. A community - even a small one - is the strongest sustainability mechanism a project has (rseng-maintenance-sustainability covers the technical side; this skill covers the human side). Governance is not bureaucracy: it is writing down who decides what, so contributors can act without waiting and maintainers can step back without collapse.

The contribution surface

Make contributing possible before promoting it:

  • CONTRIBUTING.md: how to set up a dev environment (rseng-reproducible-environments), run tests (rseng-testing), propose changes (rseng-version-control-review), and what kinds of contribution are welcome (docs, examples and issue triage count).
  • Code of conduct: adopt the Contributor Covenant rather than writing one; name real enforcement contacts - an unenforceable CoC is worse than none.
  • Issue templates and labels: a good-first-issue label with genuinely scoped starter tasks is the single best onboarding tool.
  • Respond to first-time contributors fast and kindly; the first interaction decides whether there is a second.
  • Name the communication channels: where questions go (discussions, a chat channel, a mailing list), stated in the README and CONTRIBUTING - an active, discoverable channel is itself a measured community-health indicator; one well-tended channel beats three dead ones.
  • Define a response timeframe and say it out loud ("issues get a first response within a week"): a stated expectation both reassures contributors and is checkable - response-within-a- defined-timeframe is how community health gets assessed from the outside. Pick a promise the maintainers can keep.

Governance, sized to the project

Write down the smallest true answer to "who decides":

  • Single maintainer: say so ("BDFL-style; decisions by @name") - honesty beats pretense of process.
  • Small team: document maintainer roles, how consensus is reached, and what happens on disagreement.
  • Community-scale: consider a lightweight governance doc covering roles, decision process, and how new maintainers are added - opensource.guide's leadership-and-governance section catalogs proven patterns.

Contribution and recognition policy: state how contributors are credited - AUTHORS/CONTRIBUTORS file, changelog mentions, and citation metadata for substantial contributions (rseng-citation-metadata). Credit is the currency research contributors are paid in; be generous and systematic.

Onboarding and the bus factor

  • Capture maintainer knowledge in docs as it is used: release runbooks (rseng-publishing-releasing), triage guidelines, architecture notes (rseng-documentation). If only one person can do a task, that task needs a document.
  • Rotate responsibilities when there are two or more maintainers; the second person on releases halves the bus-factor risk.
  • Handover: when a maintainer leaves, announce it, transfer forge permissions and registry ownership explicitly, and record the change - abandoned-looking ownership blocks both contributors and security response (rseng-security).

The wider community toolkit

Measurement, support and onboarding each have their own skill: community health metrics (rseng-community-metrics), support operations and the answer-once pipeline (rseng-user-support), and the contributor funnel from first issue to regular (rseng-contributor-onboarding) - this skill owns the rules and structures they operate within.

Sustaining participation

  • Roadmap visibly (even a pinned issue): contributors invest where direction is clear (rseng-management-planning).
  • Thank and release often: shipped contributions retain contributors; ones stuck in review for months lose them.
  • Watch for burnout signals in maintainers - unanswered issues and guilt-driven replies - and respond by narrowing scope honestly (declaring feature-freeze or maintenance-mode is legitimate governance).

Working with this skill

This skill is source-independent: its authority is the community guidance linked below.

Learn more (verified):

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

Related skills

Check whether any of these applies before moving on:

  • rseng-citation-metadata - systematic contributor credit
  • rseng-community-metrics - measures the stated promises
  • rseng-contributor-onboarding - funnel and first-issue curation
  • rseng-maintenance-sustainability - technical side of sustainability
  • rseng-security - ownership handover unblocks security response
  • rseng-user-support - support channel operations
<!-- 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