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

rseng-storytelling

Covers telling the story of research data, software and projects to broad audiences: narrative structure for data stories, turning milestones into human-centered stories, and citizen-science engagement - recruiting contributors, closing the feedback loop with data stories, honest narrative that never oversells. Use when the user wants to explain a project, dataset or tool to non-specialists, mentions storytelling, outreach, public engagement or citizen science, or needs project stories for websites, funders or volunteers. (Research-facing outputs - software papers, talks, announcements: rseng-science-communication; in-repo docs: rseng-documentation.)

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

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

実行スコア 未検証

インストール方法を見る

含まれるファイル(2)

  • SKILL.md6.4 KB
  • references.md554 B

SKILL.md(原文)

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

Storytelling for research data, software and projects

Facts inform specialists; stories move everyone else. A research project that can only speak in methods loses the audiences that sustain it - volunteers, funders, institutions, the public. The craft is honest narrative: real people, real stakes, real uncertainty, built on the same verified artifacts the rest of this pack maintains. rseng-science-communication covers research-facing outputs (papers, talks, announcements); this skill covers the narrative layer for everyone else - and the citizen-science setting where storytelling is not decoration but the engine of participation.

Narrative structure that works for research

  • Lead with a person or a question, not an institution: "Maria photographs the same hedgerow every week - here is what 40,000 photos like hers revealed" beats "the consortium collected image data".
  • The story arc is the research arc, honestly told: question, struggle (failed approaches are relatable - and true), turning point, what we know now, what remains open. Uncertainty told plainly builds trust; certainty theater destroys it when it unravels.
  • One story, one idea: pick the single finding or moment; link the rest. The paper holds everything; the story holds one thing.
  • Concrete beats abstract: a number needs a comparison ("enough water to fill 300 pools"), a dataset needs a face, software needs a user whose day it changed.

Data stories

Data storytelling turns datasets into narratives with evidence:

  • Structure: context (why this data), the reveal (the pattern, shown not told), the meaning (what changes because we know). Build the reveal on honest visualization - the colormap and axis discipline from rseng-scientific-visualization applies doubly for lay audiences, who cannot defend themselves against a truncated axis.
  • Every number in the story traces to the pipeline (rseng-reproducibility): a story that cites its data (with the DOI - rseng-citation-metadata) and links "explore it yourself" (a live view or notebook) respects the audience and models open science (rseng-open-science-practices).
  • Accessibility is part of the craft: alt text that tells the story of the figure, plain language, translated summaries where the community needs them (rseng-ux-accessibility).

Software and project stories

  • Software stories are user stories: what could someone do the day after the release that they could not before? Frame releases, milestones and even bugfixes through the person affected (rseng-science-communication handles the announcement mechanics; this skill supplies its narrative spine).
  • Project stories need characters: the PhD student whose analysis went from weeks to hours, the museum volunteer whose transcription surfaced in a paper. Get consent for every named appearance, and share credit generously - people amplify stories they are in (rseng-community-governance's recognition habits).
  • The failure story is underused and powerful: what broke, what it taught, what changed - engineering credibility for the project and normalized error for the field (rseng-trainer's errors-are-curriculum, told outward).

Citizen science: storytelling as infrastructure

In citizen science the story IS the recruitment, retention and ethics layer (the ECSA ten principles set the frame - genuine science, mutual benefit, acknowledged contributors):

  • Recruit with purpose, not tasks: "help us track the spring earlier every year" outperforms "classify images". State honestly what participation contributes to the science.
  • Close the loop relentlessly: contributors who never learn what their data became stop contributing. Data stories back to the community - "your observations did THIS" - are the retention mechanism, and platforms (SciStarter, EU-Citizen.Science) expect them.
  • Acknowledge visibly: contributors in publications and releases per the project's stated policy, milestones celebrated with the community, results announced to participants BEFORE or with the press.
  • Keep the science honest in translation: simplification may not become distortion; the project's own findings, limits and data practices (rseng-data-management) are told truthfully - trust is the citizen-science currency, spent once.
  • AI-assisted storytelling is disclosed like any other AI contribution (rseng-ai-declaration) - audiences increasingly ask, and the honest answer is cheap.

Working with this skill

This skill is source-independent: its authority is the citizen science community's principles and platforms linked below, combined with the verified artifacts of the project itself. It is the broad-audience narrative layer over rseng-science-communication.

Learn more (verified):

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

Related skills

Check whether any of these applies before moving on:

  • rseng-ai-declaration - disclose AI-assisted storytelling
  • rseng-community-governance - consent and recognition habits
  • rseng-data-management - truthful data practices in stories
  • rseng-science-communication - research-facing communication mechanics
  • rseng-scientific-visualization - honest figures for lay audiences
  • rseng-ux-accessibility - alt text and plain language
<!-- 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 のスキルをすべて見る

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