Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
103 changes: 103 additions & 0 deletions .claude/skills/nature-workflow/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,103 @@
---
name: nature-workflow
description: Use when the user explicitly asks for Nature Skills, nature-skills, Nature style, Nature-style, Nature Communications, Nature-family, CNS, high-impact journal, or Springer Nature workflows, including Nature figure work, polishing, writing, reviewer critique, high-impact journal major revision response, Nature/CNS citations, Nature data-sharing workflows, paper readers, reviewer response, paper-to-PPT, submission checklist, or Nature-specific academic-search workflows.
---

# Nature Workflow Bridge

This skill is a bridge to the upstream `nature-skills` bundle, not a simplified
clone of it. Its job is to route the user's request to the right original
`nature-*` skill when that skill is installed or otherwise available, and to
fall back to ScholarAIO's existing skills only when the original upstream skill
cannot be used in the current host.

## Direct-Use Policy

Use the original upstream nature-* skill directly whenever it is available. Do
not emulate, summarize, or partially rewrite upstream behavior from this bridge.
Do not copy only SKILL.md from upstream; direct use requires the whole skill
directory, including `manifest.yaml`, `static/`, `references/`, scripts, assets,
and `skills/_shared` when the upstream skill references it.

If the upstream skill is unavailable, say so, then use the ScholarAIO fallback
route from `references/upstream-skill-map.md`. Mark the output as a ScholarAIO
fallback, not as an upstream-equivalent Nature Skills result.

## Reference Loading

Load only what the current request needs:

- `references/upstream-skill-map.md`: load for routing decisions or when the
request could match more than one upstream skill.
- `references/bridge-policy.md`: load when installation, direct-use behavior,
upstream fidelity, or fallback limitations matter.
- `references/upstream-install.md`: load when the user needs the original
upstream `nature-*` skills installed or asks whether this bridge is a
simplified local copy.
- `references/quickstart.md`: load when the user asks how to use the bridge or
wants example prompts.

## First Pass

Classify the request before doing work:

1. **Upstream target**: one or more of `nature-figure`, `nature-polishing`,
`nature-writing`, `nature-reviewer`, `nature-citation`, `nature-data`,
`nature-reader`, `nature-response`, `nature-paper2ppt`, or
`nature-academic-search`.
2. **Availability**: original upstream skill available, installed through a
plugin/local skill path, or unavailable.
3. **ScholarAIO fallback**: only if upstream cannot be used.
4. **Evidence state**: manuscript/text/PDF/figures/comments/data/references
supplied, workspace available, or missing inputs.

State the upstream target and whether direct upstream use is available before
doing substantial work.

## Route Table

| User intent | Primary route |
|-------------|---------------|
| Nature/high-impact scientific figure, publication plot, manuscript figure, figures4papers-style output | `nature-figure` |
| Nature-style polishing, manuscript prose polish, Chinese-to-English academic polish | `nature-polishing` |
| Draft/rebuild abstract, introduction, methods, experiments, discussion, conclusion, title, or manuscript argument | `nature-writing` |
| Pre-submission reviewer critique, mock peer review, Nature-style reviewer report | `nature-reviewer` |
| Nature/CNS citation support, claim-to-reference mapping, reference-manager export | `nature-citation` |
| Data Availability, repository plan, FAIR metadata, accession/DOI/source-data/code availability | `nature-data` |
| Full-paper bilingual reader, source-grounded Markdown reader, paper translation/reading | `nature-reader` |
| Reviewer comments, rebuttal, point-by-point response letter, major/minor revision response | `nature-response` |
| Paper-to-PPT, Chinese journal-club PPTX, group meeting deck from a paper | `nature-paper2ppt` |
| Multi-source literature search, citation verification, MeSH/search strategy, citation-file management | `nature-academic-search` |

Submission package is only one scenario. Do not require a full submission
package when the user asks only for polishing, figures, reading, PPT, citation
support, reviewer critique, Data Availability, response, or search.

## ScholarAIO Fallbacks

When the original upstream skill is not available:

- figure work -> `/draw`
- prose polish -> `/writing-polish`
- manuscript writing -> `/paper-writing`
- reviewer response -> `/review-response`
- citation/search/export -> `/search` + `/citation-check` + `/export`
- paper reading/translation -> `/show` + `/translate`
- paper-to-PPT or document packaging -> `/document`
- literature search -> `/search` or `/websearch`

Use fallbacks conservatively. Preserve upstream-style guardrails such as
non-invention, source grounding, explicit missing inputs, and final-output
verification, but do not claim to have executed the original upstream workflow
unless the original skill was actually used.

## Output Shape

For routing tasks, return:

1. `Upstream target:` selected `nature-*` skill or skill sequence.
2. `Mode:` direct upstream use or ScholarAIO fallback.
3. `Route:` exact skill sequence.
4. `Immediate next action:` file to inspect, command to run, or question to ask.
5. `Guardrails:` only the relevant non-invention, source-grounding, or
verification constraints for this request.
64 changes: 64 additions & 0 deletions .claude/skills/nature-workflow/references/bridge-policy.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,64 @@
# Bridge Policy

This bridge integrates ScholarAIO with the upstream `nature-skills` project
without degrading that project into a simplified local rewrite.

## Direct Use Comes First

Use the original upstream nature-* skill directly whenever it is installed or
available through the current agent host. The upstream skill is the source of
truth for its workflow.

Do not emulate upstream behavior from this bridge. Do not copy only SKILL.md.
Do not flatten upstream `static/`, `references/`, scripts, assets, or
`manifest.yaml` into a short local summary.

Direct upstream use means the whole skill directory is available, including:

- `SKILL.md`
- `manifest.yaml`, when present
- `static/`
- `references/`
- scripts and assets
- `skills/_shared` for upstream skills that reference the shared layer

## What This Bridge Does

- Classifies the user's request into the upstream `nature-*` skill index.
- Preserves the upstream product language: Nature/high-impact academic workflow,
not submission-only.
- Routes to the original upstream skill when possible.
- Routes to ScholarAIO's existing skills only as a fallback or for local
repository-native work.
- States clearly when a result is a ScholarAIO fallback rather than an
upstream-equivalent result.

## What This Bridge Does Not Do

- It does not vendor or rewrite the entire upstream `nature-skills` repository.
- It does not claim that `/draw`, `/writing-polish`, `/paper-writing`,
`/document`, or other ScholarAIO fallbacks are identical to upstream
`nature-*` workflows.
- It does not require a submission package unless the user explicitly asks for
one.
- It does not invent citations, data identifiers, repository URLs, reviewer
expectations, journal rules, figure evidence, manuscript claims, or policy
details.

## Upstream Installation Reminder

The upstream repository explicitly warns that each skill is a folder-based unit.
Install or reference the whole skill directory, plus `skills/_shared` when
needed. Copying only `SKILL.md` silently breaks many upstream workflows.

Upstream repository checked during this branch:

```text
https://github.com/Yuan1z0825/nature-skills.git
local checked HEAD: 5e31dbb235fc9aca8d40dadd160583d2403dc9f7
origin/main observed: 5e31dbb235fc9aca8d40dadd160583d2403dc9f7
```

If exact parity matters, refresh the upstream clone and inspect the current
`README.md`, `SKILL.md`, `manifest.yaml`, `static/`, and `references/` files
before finalizing behavior.
47 changes: 47 additions & 0 deletions .claude/skills/nature-workflow/references/quickstart.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
# Quickstart

Use `nature-workflow` when the user asks for Nature Skills, Nature-style,
Nature-family, CNS, high-impact academic, or target-journal help and the exact
upstream `nature-*` skill is not already obvious.

Submission package is only one scenario. The bridge also covers Nature/high-impact
figure, polishing, writing, reader, paper2ppt, academic search, citation, data,
reviewer critique, and reviewer-response workflows.

## Example Prompts

```text
/nature-workflow Polish this abstract in Nature Communications style.
```

```text
/nature-workflow Make this paper into a Chinese journal-club PPT.
```

```text
/nature-workflow Use Python to create a Nature-style multi-panel figure for
these benchmark results.
```

```text
/nature-workflow Draft a Data Availability statement and repository plan for
this manuscript.
```

```text
/nature-workflow Simulate a Nature-style reviewer critique for this draft.
```

```text
/nature-workflow Add Nature/CNS-family citation support to these manuscript
claims and export RIS.
```

## Expected First Response

The bridge should first say:

1. which upstream `nature-*` skill applies
2. whether direct upstream use is available
3. the ScholarAIO fallback if upstream is unavailable
4. the first concrete next action
53 changes: 53 additions & 0 deletions .claude/skills/nature-workflow/references/upstream-install.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
# Upstream Install

Use this reference when the user wants direct upstream Nature Skills behavior,
asks whether ScholarAIO has copied a simplified version, or needs to make the
original `nature-*` skills available in the current agent host.

## Codex Plugin Path

Install the complete upstream bundle through the Codex plugin marketplace:

```bash
codex plugin marketplace add https://github.com/Yuan1z0825/nature-skills --ref main
codex plugin add nature-skills@nature-skills
```

Restart Codex or start a new session after installation so the `nature-*` skills
are discovered.

## Manual Local-Skill Path

Clone the upstream repository:

```bash
git clone https://github.com/Yuan1z0825/nature-skills.git
cd nature-skills
```

Install all current upstream skills as whole directories:

```bash
mkdir -p ~/.codex/skills
cp -R skills/_shared ~/.codex/skills/
for d in skills/nature-*; do
cp -R "$d" ~/.codex/skills/
done
```

Install one upstream skill as a whole directory:

```bash
mkdir -p ~/.codex/skills
cp -R skills/_shared ~/.codex/skills/
cp -R skills/nature-reader ~/.codex/skills/
```

## Fidelity Rule

Copy the whole skill directory. Do not copy only `SKILL.md`.

The original upstream skills may rely on `manifest.yaml`, `static/`,
`references/`, scripts, assets, README context, and `skills/_shared`. A local
summary or partial folder is not the same product and must be described as a
fallback or adaptation.
27 changes: 27 additions & 0 deletions .claude/skills/nature-workflow/references/upstream-skill-map.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
# Upstream Skill Map

This map follows the upstream `nature-skills` README skill index. It is a route
map, not a replacement for the upstream skills.

| Upstream skill | Upstream purpose | Typical trigger | ScholarAIO fallback when upstream is unavailable |
|----------------|------------------|-----------------|--------------------------------------------------|
| `nature-figure` | Nature/high-impact Python or R figure workflow with figure contract, export QA, and source-data traceability. | Nature figure, publication plot, scientific figure, figures4papers, manuscript figure. | `/draw` for diagrams/visuals; keep evidence/source-data checks explicit. |
| `nature-polishing` | Nature-style academic prose polishing, restructuring, and Chinese-to-English manuscript refinement. | Nature style, polish, academic writing, manuscript paragraph, abstract polish. | `/writing-polish`. |
| `nature-writing` | Nature-style manuscript section drafting and argument restructuring. | Nature writing, write abstract, write introduction, manuscript draft, section reconstruction. | `/paper-writing`. |
| `nature-reviewer` | Nature-style reviewer assessment with three referee reports and cross-review synthesis. | Nature reviewer, pre-submission review, mock peer review, reviewer report, critique. | Use `/paper-writing` or `/citation-check` only for downstream fixes; if no upstream skill exists, produce a bounded fallback critique and mark it non-equivalent. |
| `nature-citation` | Strict Nature/CNS-family citation retrieval, claim segmentation, support grading, and ENW/RIS/Zotero RDF export. | Nature citation, CNS citation, supporting references, add citations, reference export. | `/search` + `/citation-check` + `/export`. |
| `nature-data` | Nature/Springer Nature Data Availability statements, repository plans, dataset citations, FAIR metadata checks. | Data Availability, repository, FAIR metadata, source data, accession number, DOI, code availability. | Use this bridge for gap inventory, then `/paper-writing` or `/writing-polish` only for wording; mark as fallback. |
| `nature-reader` | Full-paper bilingual Markdown reader with source anchors, figure/table grounding, and no summary-only degradation. | Nature reader, full markdown, paper md, 原文对照, 图文对应, 全文翻译. | `/show` + `/translate`. |
| `nature-response` | Point-by-point reviewer response letters with comment triage, action mapping, and risk checks. | response to reviewers, rebuttal letter, major revision, 审稿意见回复. | `/review-response`. |
| `nature-paper2ppt` | Chinese PPTX decks from scientific papers for journal club, group meeting, or academic presentation. | paper PPT, journal club, paper to slides, paper presentation, 组会PPT. | `/show` or `/paper-guided-reading` for evidence, then `/document`. |
| `nature-academic-search` | Multi-source literature search, citation verification, MeSH strategy, citation-file management, and reference management. | search papers, academic search, literature search, verify DOI, reference management. | `/search`, `/websearch`, `/citation-check`, `/export`. |

## Route Principles

- Prefer the upstream skill when available.
- Use ScholarAIO fallbacks only when the upstream skill cannot be executed in
the current environment.
- Keep the upstream trigger breadth: this is not submission-only.
- Submission package is only one scenario; most upstream skills can be invoked
for ordinary high-impact academic writing, reading, figures, slides, citation,
search, or data work.
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ The canonical project skill source is `.claude/skills/`. Cross-agent discovery p
Representative skills to check first:

- Core research: `search`, `show`, `ingest`, `workspace`, `audit`, `translate`
- Writing: `academic-writing`, `literature-review`, `paper-guided-reading`, `paper-writing`, `citation-check`, `writing-polish`, `review-response`, `research-gap`, `poster`, `technical-report`
- Writing: `academic-writing`, `nature-workflow`, `literature-review`, `paper-guided-reading`, `paper-writing`, `citation-check`, `writing-polish`, `review-response`, `research-gap`, `poster`, `technical-report`
- Outputs and tooling: `draw`, `document`, `publish`, `websearch`, `webextract`, `scientific-runtime`, `scientific-tool-onboarding`

If a workflow has grown into a reusable playbook, move it into a skill instead of expanding this file.
Expand Down
2 changes: 1 addition & 1 deletion AGENTS_CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ canonical skill 源是 `.claude/skills/`。其他 agent 发现入口都只是它
代表性 skills:

- 核心科研:`search`、`show`、`ingest`、`workspace`、`audit`、`translate`
- 写作:`academic-writing`、`literature-review`、`paper-guided-reading`、`paper-writing`、`citation-check`、`writing-polish`、`review-response`、`research-gap`、`poster`、`technical-report`
- 写作:`academic-writing`、`nature-workflow`、`literature-review`、`paper-guided-reading`、`paper-writing`、`citation-check`、`writing-polish`、`review-response`、`research-gap`、`poster`、`technical-report`
- 输出与工具:`draw`、`document`、`websearch`、`webextract`、`scientific-runtime`、`scientific-tool-onboarding`

如果一个流程已经长成可复用 playbook,就把它做成 skill,而不是继续膨胀这个文件。
Expand Down
4 changes: 4 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/).

## [Unreleased]

### Added

- **Nature workflow bridge skill** ([#107](https://github.com/ZimoLiao/scholaraio/issues/107)): Added a ScholarAIO `nature-workflow` bridge skill that routes Nature Portfolio writing and figure workflows to the upstream `nature-skills` repository when installed, keeps ScholarAIO-native fallbacks explicit, documents the install and quick-start path, and includes deterministic plus product-demo fixtures that generate reviewable manuscript, figure, slide, and QA artifacts.

## [1.5.0] — 2026-05-24

### Added
Expand Down
2 changes: 1 addition & 1 deletion CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ Claude-specific notes:

- Use `/memory` to edit this file or imported project memory.
- Keep shared workflows in skills, not in this file.
- Shared project guidance, including core writing skills such as `academic-writing`, `paper-guided-reading`, `poster`, and `technical-report`, is imported from `@AGENTS.md`.
- Shared project guidance, including core writing skills such as `academic-writing`, `nature-workflow`, `paper-guided-reading`, `poster`, and `technical-report`, is imported from `@AGENTS.md`.
- Important canonical pointers remain: `scholaraio/stores/explore.py`, `scholaraio/projects/workspace.py`, `scholaraio/services/insights.py`, `scholaraio/services/translate.py`, `scholaraio/interfaces/cli/`, `scholaraio/interfaces/cli/compat.py` for internal CLI wiring, and `scholaraio/cli.py` as the published entrypoint.

@AGENTS.md
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -103,6 +103,7 @@ run the migration in the upgraded checkout that contains your `data/`,
For writing tasks, start with the router-style writing entry when the deliverable is clear but the workflow is not. The current writing stack is organized around:

- `academic-writing`: route by deliverable and writing stage
- `nature-workflow`: bridge to the upstream `nature-skills` bundle for Nature/high-impact figures, polishing, writing, reviewer critique, citation, Data Availability, paper reading, reviewer response, paper-to-PPT, and academic search; direct upstream skills are preferred when available
- `literature-review`: long-form review and survey writing
- `paper-guided-reading`: guided deep reading of a single paper from fuzzy search to full-text analysis
- `paper-writing`: manuscript sections and paper-focused drafting
Expand Down
1 change: 1 addition & 0 deletions README_CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -101,6 +101,7 @@ scholaraio index --rebuild
针对写作类任务,如果用户已经知道交付物,但还不确定该走哪条 workflow,优先从写作总入口开始。当前写作能力主要包括:

- `academic-writing`:按交付物和写作阶段分流
- `nature-workflow`:对接上游 `nature-skills` bundle,覆盖 Nature/高影响力论文配图、润色、写作、审稿人视角评估、引用、Data Availability、论文阅读、审稿回复、paper-to-PPT 和学术检索;原始上游 skill 可用时优先直连
- `literature-review`:长文综述与 survey
- `paper-guided-reading`:从模糊检索到单篇深读的引导式精读
- `paper-writing`:论文具体章节写作
Expand Down
4 changes: 4 additions & 0 deletions clawhub.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -74,6 +74,10 @@ skills:
path: .claude/skills/academic-writing
description: "Route academic-writing requests by deliverable: review, paper sections, rebuttal, PPT, poster, or technical report"

- name: scholaraio/nature-workflow
path: .claude/skills/nature-workflow
description: "Bridge Nature/high-impact workflows to upstream nature-skills, with ScholarAIO fallbacks"

- name: scholaraio/literature-review
path: .claude/skills/literature-review
description: "Write a literature review based on workspace papers: topic organization, narrative, gap identification"
Expand Down
Loading
Loading