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

rseng-ux-accessibility

Covers user experience and accessibility for research software: UX disciplines, accessibility practice, Design Thinking, scoping a Minimum Viable Product versus a Minimum Loveable Product, Nielsen's usability heuristics, and prototyping with tools like Figma and Miro. Also covers WCAG conformance for web-facing tools, accessibility testing, CLI usability guidelines and inclusive defaults. Use PROACTIVELY when creating or reshaping a user-facing interface (CLI, GUI, web), and when the user designs a research tool's interface (web, GUI or CLI), asks how to make research software usable or accessible, plans user testing or prototyping, or mentions usability heuristics, WCAG, UX or a11y in a research software context.

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

fdiblen/rseng-agent-skillsスター 24(GitHub 24 + cccskills 0)
連携ツールFigma

実行スコア 未検証

インストール方法を見る

含まれるファイル(2)

  • SKILL.md5.2 KB
  • references.md327 B

SKILL.md(原文)

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

UX and accessibility for research software

Research software succeeds when researchers can actually use it; UX is not cosmetic polish but part of software quality. This skill treats usability as an engineering practice, not cosmetic polish.

Practice

  • Know the disciplines: UX research (understanding users and tasks), interaction design, visual design and accessibility are different jobs - be explicit about which one a request needs.
  • Start from users and tasks, not features: apply Design Thinking - empathize with the target researchers, define the task, ideate, prototype cheaply (Figma or Miro before code), test with real users.
  • Scope deliberately: an MVP proves the workflow works; a Minimum Loveable Product adds the qualities that make researchers adopt it. Pick which one the project stage needs and say so.
  • Evaluate against Nielsen's usability heuristics (visibility of status, match with the users' world, error prevention and recovery, consistency, minimalism); they apply to CLIs and notebooks as much as GUIs - clear --help, sane defaults and good error messages are UX.
  • Accessibility is a requirement, not an extra: color-contrast, keyboard navigation and screen-reader support for web tools; readable output and terminal-friendly formats for CLIs.
  • Usability findings become issues like any other defect; retest after fixing (pair with rseng-testing for automated regression of CLI/API ergonomics where possible).

Accessibility, concretely

  • Web-facing research tools target WCAG (the W3C accessibility standard; level AA is the common bar and often a legal one for publicly funded services): text alternatives for non-text content, sufficient contrast, full keyboard operability, labeled form controls, and structure a screen reader can navigate (headings, landmarks, table headers).
  • Test it, do not assume it: automated checkers (axe-class tools in CI) catch the mechanical failures; a keyboard-only walk-through and a screen-reader pass catch the rest. Accessibility findings are defects with severities, tracked like any other (rseng-project-tracking).
  • Scientific outputs have accessibility too: colorblind-safe and perceptually honest palettes (rseng-scientific-visualization), alt text that states what the figure SHOWS ("temperature rises sharply after 1980"), not what it is ("a line chart"), and data tables as alternatives to figure-only results (rseng-science-communication).
  • Documentation accessibility: plain language, defined jargon, meaningful link text, heading hierarchy - the same qualities that serve newcomers and non-native speakers (rseng-documentation, rseng-trainer's calibration).

CLI usability, concretely

Most research tools are CLIs, and CLI UX is a codified craft (the Command Line Interface Guidelines distill it):

  • --help that teaches: usage, an actual example, and the most-used flags first; man-page or docs parity (rseng-documentation).
  • Errors that help recovery: say what failed, on which input, and what to try - "config key 'stations' missing (stations.json)" beats a traceback (rseng-defensive-coding's fail-loud, made humane).
  • Sane defaults, explicit overrides; standard conventions respected (exit codes for CI - rseng-ci-cd; stdout for data, stderr for messages so pipes work; --version; no color when not a TTY).
  • Progress for long operations (rseng-hpc-computing jobs excepted - log lines there), and quiet/verbose flags because both scripting and debugging are real uses.
  • Test the ergonomics: golden-file tests on --help and error messages keep promised UX from rotting (rseng-testing).

Working with this skill

The generated references.md beside this file lists the source material and pointers:

  • references.md - verified Learn more pointers

Learn more (verified):

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

Related skills

Check whether any of these applies before moving on:

  • rseng-defensive-coding - humane fail-loud error messages
  • rseng-documentation - docs accessibility and help parity
  • rseng-science-communication - accessible slides and figures
  • rseng-scientific-visualization - colorblind-safe honest palettes
  • rseng-testing - golden-file tests on CLI ergonomics
  • rseng-user-support - error-message questions reveal UX gaps
<!-- 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 のスキルをすべて見る

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