agentsclimarketplace

Scientific feedback

Skill jjfroehlich/agent-skills-for-academic-research/skills/scientific-feedback

Agent skills for academia research: writing, dataviz, publishing, communication, career, and more.

Install
npx -y skills add jjfroehlich/agent-skills-for-academic-research --skill scientific-feedback

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use this skill when a scientist asks for holistic or prioritized feedback, critique, review, readiness check, or look-over judgment on their scientific artifact: manuscript, draft, paper, preprint, thesis chapter, presentation, slides, poster, grant proposal or outline, research plan, project pitch, collaborator update, paper notes used to support a decision, mentoring document, or lab artifact. Trigger even when phrased as what should I fix first, where will reviewers push back, or does this hang together. Prefer narrower skills for isolated rewrites, single-lens figure or chart work, reviewer-response drafting, literature summaries, project-choice analysis without an artifact, code or statistics debugging, clinical/legal determinations, and non-scientific application documents.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

7.4 KB, as published. Nobody here has run it

Scientific Feedback

Purpose

Give integrated, prioritized feedback on scientific artifacts by routing through the right domain lenses and returning one coherent revision path.

Use this skill when

  • The user asks to review, critique, sanity-check, or give feedback on a scientific artifact.
  • The artifact spans more than one narrow task: manuscript plus figures, slides plus story, grant plus feasibility, paper notes plus project decision, or lab document plus tone.
  • The user wants reviewer-style, mentor-style, collaborator-style, committee-style, or quick-scan feedback.
  • Multiple specialist perspectives may matter: writing, communication, figures, publishing, grants, literature synthesis, project strategy, or lab culture.

Do not use this skill when

  • The request is a single narrow production task, such as "rewrite this paragraph," "choose this chart," "draft a cover letter," or "format this slide."
  • The user asks only for literature search, citation formatting, code debugging, statistical analysis, or institutional/legal/clinical determinations.
  • The artifact should clearly be handled by one domain lens without integration.

Core workflow

  1. Identify the artifact, audience, destination, deadline, relationship, and requested review depth.
  2. State the inferred goal, feedback mode, and selected domain lenses before critiquing.
  3. Ask only for missing context that would change priorities; otherwise proceed with explicit assumptions.
  4. Apply the narrowest useful lenses, then integrate findings into one revision sequence.
  5. Separate strengths, blocking issues, major revisions, secondary improvements, and optional polish.
  6. Adapt tone to the relationship: reviewer, mentor, collaborator, supervisor, committee, or self-revision.
  7. End with the next action: revise, cut, restructure, verify, collect missing evidence, rehearse, submit, or route to a specialist domain.

Routing / specialist lenses

Use portable routing language. If the environment supports loading another skill, consult the named skill; otherwise apply the summarized lens.

  • Apply the scientific-writing lens for manuscript prose, section function, argument structure, claim calibration, figure legends, and revision-ready wording.
  • Apply the scientific-communication lens for talks, slides, posters, chalk talks, pitches, story, audience fit, delivery, and Q&A.
  • Apply the data-visualization-and-figures lens for plots, tables, heatmaps, microscopy, graphical abstracts, visual hierarchy, accessibility, uncertainty display, and export readiness.
  • Apply the publishing-and-peer-review lens for journal submission, peer-review reports, editor decisions, reviewer ethics, and response-to-reviewers strategy.
  • Apply the grant-writing lens for proposals, specific aims, funder fit, significance/innovation/approach, feasibility, budget alignment, and reviewer-facing funding narratives.
  • Apply the literature-reading-and-synthesis lens for paper reading, figure/table extraction, claim-evidence notes, synthesis matrices, and literature-tracking feedback.
  • Apply the research-strategy-and-project-design lens for research questions, project triage, hypothesis generation, decisive tests, risk, and kill criteria.
  • Apply the mentoring-management-and-lab-culture lens for lab documents, mentoring compacts, IDP plans, feedback scripts, conflict diagnosis, lab culture, and power-aware management artifacts.

Clarifying questions

Ask at most three, and only when the answer changes feedback priorities:

  • What is the artifact's destination and audience?
  • What feedback mode do you want: quick scan, integrated review, reviewer-style critique, mentor-style coaching, line-level edit, or readiness check?
  • What constraints matter: deadline, word/slide/page limit, venue, funder, journal, relationship, or known concern?

Output formats

  • Quick scan: goal, selected lenses, top 3 priorities, strengths, risks, and next action.
  • Integrated feedback report: scope, strengths, blocking issues, major revisions, lens-specific notes, revision sequence, and missing context.
  • Reviewer-style critique: summary assessment, major concerns, minor concerns, overclaim risks, and action priorities.
  • Mentor/collaborator feedback: what works, highest-leverage changes, suggested wording, questions to discuss, and supportive next step.
  • Readiness check: ready/needs revision/blocked, must-fix items, assumptions, and specialist follow-up.

Reference routing

  • Open references/artifact-routing.md when deciding which specialist lenses apply.
  • Open references/review-modes.md when choosing quick scan, focused review, integrated review, reviewer-style, mentor-style, or line-edit mode.
  • Open references/feedback-principles.md when feedback needs stronger prioritization, specificity, uncertainty handling, or non-overwhelming structure.
  • Open references/tone-and-relationship.md when feedback must fit the role relationship or power dynamic.
  • Use checklists/feedback-report-checklist.md before returning any integrated feedback report.
  • Use artifact-specific checklists for manuscripts, slides, and posters when those are the primary artifact.
  • Use examples when the user asks for a model report shape.

Quick checklist

  • Is the artifact goal and destination explicit?
  • Did you choose only the lenses that matter for this artifact?
  • Are blocking issues separated from major revisions, secondary improvements, and optional polish?
  • Does each comment point to an action the user can take?
  • Are missing context, unsupported inferences, and relationship constraints marked clearly?
  • Does the output integrate lenses rather than dumping separate mini-reviews?

Common pitfalls

  • Duplicating a whole domain skill instead of routing to it.
  • Giving generic encouragement or taste-level critique.
  • Mixing line edits with strategy feedback without naming the review mode.
  • Overwhelming the user with every possible problem instead of a revision sequence.
  • Treating mentor feedback, peer feedback, journal review, and committee feedback as the same tone.
  • Inventing source-backed rules or provenance for this no-source orchestrator.

Quality bar

  • The report must teach the user what to fix first and why.
  • Feedback must be artifact-aware, relationship-aware, and scoped to the requested mode.
  • Domain lenses must be integrated into one coherent revision path.
  • User-facing outputs must not expose workbench provenance, source lists, raw URLs, or private details.

Reference files

  • references/artifact-routing.md
  • references/review-modes.md
  • references/feedback-principles.md
  • references/tone-and-relationship.md

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.