本文へ移動
cccskills
無料GitHub で公開

rseng-user-support

Covers running user support as an operation for research software: triaging and answering support requests, converting recurring questions into documentation and FAQ entries, office hours and support channels, forum gardening, and feeding support signals into the roadmap. Use when support questions arrive faster than they are answered, when the same question keeps being answered by hand, when the user asks how to organize support, office hours or a helpdesk for their software, or when support load is invisible to planning.

日本語の概要は準備中です。原文の説明を表示しています。

fdiblen/rseng-agent-skillsスター 24(GitHub 24 + cccskills 0)

実行スコア 未検証

インストール方法を見る

含まれるファイル(2)

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

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

User support for research software

Support is where users meet the project - and in research software it is usually nobody's job, so it becomes the maintainer's evenings. Running it as a lightweight operation turns the same effort into documentation, roadmap signal and community goodwill. The core loop: answer once, then make the answer permanent - every question answered twice by hand is a process failure.

The support-to-documentation pipeline

The habit that pays off most, and ideal agent work:

  • Answer the question where it was asked, then immediately route it: a recurring how-do-I question becomes a FAQ entry or documentation section (rseng-documentation), an error-message question becomes a better error message (rseng-ux-accessibility) or a troubleshooting entry, a "can it do X" becomes a tracked feature request or a documented limitation (rseng-project-tracking).
  • Link, do not retype: subsequent identical questions get the canonical link plus a sentence - which also reveals when the canonical answer is not findable enough (a search-terms problem, fixable in headings).
  • Review the support log periodically: three questions on the same topic in a month is a docs gap or a design gap (rseng-lessons-learned captures the pattern; rseng-ux-accessibility asks whether the interface caused it).

Channels and expectations

  • Fewer channels, tended well: one primary question channel (forum-style with public archives beats chat for reuse - the answer helps the next searcher) plus the issue tracker for bugs; state in the README where questions GO and what response time to expect (the same stated-promise discipline as rseng-community-governance).
  • Public by default: private support answers help one person; public ones compound. Redirect kindly from private mail to the public channel except where data sensitivity demands otherwise (rseng-regulatory-compliance).
  • Office hours work for research software: a recurring short slot (with notes posted after) concentrates support load, gives users a human moment, and surfaces the confusions that never get written down. Announce via the community digest (rseng-science-communication).
  • Support is contribution: answering questions counts, is credited (rseng-citation-metadata's all-kinds rule), and is a proven on-ramp - active answerers make good future maintainers (rseng-contributor-onboarding).

Triage discipline

  • Separate the streams on arrival: bug (to the tracker with reproduction info - rseng-debugging's reproduce-first), usage question (answer + pipeline), feature request (tracker with the need, not the demanded design), sensitive report (security contact - rseng-security).
  • The first response does not need the answer: acknowledging with a timeframe beats silence while a fix is researched - first-response time is the retention metric (rseng-community-metrics).
  • Reproduce before diagnosing user-reported bugs; ask for the environment, exact command and full error (a saved reply or issue template collects these - rseng-community-governance).
  • It is fine to say no and to say "out of scope" - kindly, with reasons and alternatives where they exist (rseng-software-reuse may know the right tool).

Support signal in planning

Support load is data: time spent, topics, affected user groups - a line in the status record (rseng-project-tracking) makes it visible in planning, fundable in proposals (support and maintenance are budgetable work - rseng-management-planning), and honest in the sustainability story (rseng-maintenance-sustainability).

Working with this skill

This skill is source-independent: it encodes community support practice for research software. It feeds rseng-documentation and rseng-project-tracking and draws on rseng-community-metrics for its health signals.

Learn more (verified):

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

Related skills

Check whether any of these applies before moving on:

  • rseng-community-metrics - first-response time is the metric
  • rseng-contributor-onboarding - answerers are future contributors
  • rseng-debugging - reproduce user-reported bugs first
  • rseng-documentation - answers become FAQ entries
  • rseng-project-tracking - requests and load feed planning
  • rseng-ux-accessibility - error messages causing the questions
<!-- related-skills:end -->

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

コメント

ログインなしで書き込めます。使ってみた感想、質問、動かなかった環境などを気軽にどうぞ。

まだコメントはありません。最初のコメントを書いてみませんか。

送信するとすぐに公開されます。メールアドレスや電話番号などの個人情報は書かないでください。URL は 2 つまでです。

0 / 1000 文字

このフォームは reCAPTCHA で保護されており、Google のプライバシーポリシーと利用規約が適用されます。

同じリポジトリのスキル

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.)

日本語の概要は準備中です。原文の説明を表示しています。

fdiblen/rseng-agent-skills242026年9月23日 更新

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.

日本語の概要は準備中です。原文の説明を表示しています。

fdiblen/rseng-agent-skills242026年9月23日 更新

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.)

日本語の概要は準備中です。原文の説明を表示しています。

fdiblen/rseng-agent-skills242026年9月23日 更新

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.)

日本語の概要は準備中です。原文の説明を表示しています。

fdiblen/rseng-agent-skills242026年9月23日 更新

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.

日本語の概要は準備中です。原文の説明を表示しています。

fdiblen/rseng-agent-skills242026年9月23日 更新

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.)

日本語の概要は準備中です。原文の説明を表示しています。

fdiblen/rseng-agent-skills242026年9月23日 更新

fdiblen のスキルをすべて見る

このスキルの問題を報告する