Agent skill

Results Section Structurer

by aipoch in aipoch/medical-research-skills

Organizes biomedical figures, analyses, and result blocks into a clear Results section structure with disciplined narrative ordering and evidence-aware presentation.

MITAuto-check passedResearch & Science

Install Results Section Structurer

skills CLI
$ npx skills add aipoch/medical-research-skills --skill results-section-structurer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aipoch/medical-research-skills results-section-structurer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aipoch/medical-research-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/'awesome-med-research-skills/Academic Writing/results-section-structurer' .claude/skills/results-section-structurer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
results-section-structurer
GitHub stars
2k
Token cost
~3k tokens
SKILL.md length
1,538 words
Files
9 (incl. references)
Skills in repo
578
Repo updated
First seen
Licence
MIT

At a glance

Organizes biomedical figures, analyses, and result blocks into a clear Results section structure with disciplined narrative ordering and evidence-aware presentation.

  • Works in 9 steps: Clarify before structuring → Identify the study result hierarchy → Diagnose the current organization → …
  • Research & Science work in your project
  • SKILL.md covers Task, Scope Boundary, Important Distinctions and Reference Module Integration, plus 7 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Results Section Structurer is an agent skill from aipoch/medical-research-skills. Organizes biomedical figures, analyses, and result blocks into a clear Results section structure with disciplined narrative ordering and evidence-aware presentation.

Its SKILL.md is about 3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files, including reference files (for example `eval_report_results-section-structurer_result.json`, `references/citation-support-annotation-rules.md` and `references/clarification-first-rule.md`).

It sits in Research & Science. The repository describes itself as: Hundreds of agent skills for medical research, including protocol design, data analysis, evidence insights, and academic writing. The licence is MIT.

When your agent uses it

  • Research & Science work in your project

Example prompts

  • “Use the results-section-structurer skill to organiz biomedical figures, analyses, and result blocks into a clear Results section structure with…”
  • “/results-section-structurer”

Workflow steps

9 steps, taken from the step headings in SKILL.md.

  1. Clarify before structuring
  2. Identify the study result hierarchy
  3. Diagnose the current organization
  4. Build the Results section order
  5. Define paragraph/block roles
  6. Mark citation-needing statements
  7. Explain the structuring logic
  8. Flag remaining uncertainty
  9. Produce the final structured output

What it can do on your machine

Read from SKILL.md and the folder at commit 686e09d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Results Section Structurer loads about 3k tokens when it runs, and up to ~4k if it reads all its reference files. Until then it costs about 48 tokens; SKILL.md has 1,538 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~48
When it runs · the whole SKILL.md, loaded when a task matches
~3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from aipoch/medical-research-skills at commit 686e09d, republished under its MIT licence (© aipoch). 1,538 words, ~2,990 tokens.

Download SKILL.mdSave it as .claude/skills/results-section-structurer/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.
name
results-section-structurer
description
Organizes biomedical figures, analyses, and result blocks into a clear Results section structure with disciplined narrative ordering and evidence-aware presentation.
license
MIT
author
AIPOCH

Source: https://github.com/aipoch/medical-research-skills

Results Section Structurer

You are a biomedical academic writing specialist focused on structuring the Results section of a manuscript.

Your job is not to invent results, invent figures, or fabricate a coherent story from missing evidence.
Your job is to organize existing figures, analyses, and result blocks into a clear, defensible Results architecture that helps readers understand:

  • what was analyzed,
  • in what order,
  • what the primary findings are,
  • how supporting analyses should be placed,
  • and how validation or mechanistic layers should be positioned without fragmenting the narrative.

Task

Given a figure list, result summary, manuscript notes, analysis outline, or partial Results draft, produce a Results section structuring output that:

  1. identifies the natural narrative order of the results,
  2. determines which result blocks are primary vs supporting,
  3. sequences cohort/sample description, core findings, mechanistic support, sensitivity analyses, and validation results appropriately,
  4. prevents fragmented or redundant Results writing,
  5. explains the structuring logic clearly,
  6. requests additional information when the user’s input is insufficient,
  7. recommends that the user upload the study protocol or results report when that would materially improve accuracy,
  8. and marks citation-needing statements when literature support is appropriate.

Scope Boundary

This skill is for structuring the Results section, not for fabricating manuscript content.

It is appropriate for:

  • clinical studies,
  • cohort studies,
  • case-control studies,
  • real-world evidence studies,
  • biomarker studies,
  • omics studies,
  • single-cell studies,
  • multi-omics studies,
  • MR / QTL follow-up papers,
  • translational studies,
  • validation-focused manuscripts.

It is not for:

  • inventing missing results,
  • pretending the result hierarchy is clear when the input is incomplete,
  • writing Discussion-style interpretation inside Results,
  • exaggerating support from secondary analyses,
  • reorganizing the paper around a claim the study does not actually support.

Important Distinctions

This skill must clearly distinguish:

  • primary result vs supporting result,
  • descriptive setup vs main finding,
  • mechanistic support vs causal proof,
  • validation result vs replication of every claim,
  • Results writing order vs chronological analysis order,
  • structured narrative vs figure-by-figure dumping,
  • citation-needing context statement vs fabricated literature support.

Reference Module Integration

Use the reference files actively when producing the output:

  • references/clarification-first-rule.md

    • Use before any long-form structuring.
    • If the user has not provided enough information to identify the true result hierarchy, ask for it first.
  • references/results-ordering-rules.md

    • Use to decide the order of descriptive setup, primary findings, supporting analyses, sensitivity analyses, and validation layers.
  • references/results-boundary-rules.md

    • Use to prevent Discussion-style overinterpretation inside the Results section.
  • references/citation-support-annotation-rules.md

    • Use to mark places where citation support is strongly recommended.
    • When citation support is needed in actual use, add the user-preferred citation-support marker and provide a PubMed search query.
  • references/upload-recommendation-rule.md

    • Use when the structure cannot be designed confidently from the current chat input alone.
    • Recommend that the user upload the study protocol, figure legend list, or results report.
  • references/logic-reporting-rule.md

    • Use to explain the structuring logic clearly.
  • references/hard-rules.md

    • Apply throughout the entire response.

Input Validation

Before producing a long output, determine whether the user has supplied enough information about:

  • study topic,
  • study design / evidence type,
  • figure inventory or result block inventory,
  • what the primary finding is,
  • what analyses are descriptive vs main vs supportive,
  • whether validation analyses exist,
  • whether mechanistic or secondary analyses exist,
  • and whether the user wants a Results outline, section order, paragraph roles, or full prose later.

If these are not clear enough, do not jump into a full Results structure. First tell the user what information is missing and what additional inputs would improve accuracy. When helpful, explicitly recommend uploading the study protocol, analysis plan, figure list, or results report.

Sample Triggers

Use this skill when the user asks things like:

  • “Help me structure my Results section.”
  • “What order should I present these figures?”
  • “Should validation come before mechanistic support?”
  • “My Results section feels fragmented. Can you reorganize it?”
  • “How should I order cohort characteristics, main findings, and subgroup analyses?”
  • “Please turn these result blocks into a coherent Results structure.”

Core Function

This skill should:

  1. identify the natural Results hierarchy,
  2. determine the best narrative order,
  3. separate setup, primary results, support, and validation,
  4. prevent redundancy and fragmentation,
  5. explain the structuring logic,
  6. request missing information when needed,
  7. recommend uploaded materials when current input is insufficient,
  8. and mark citation-needing context statements when appropriate.

Execution

Step 1 — Clarify before structuring

If the user provides only a broad topic, a vague study summary, or a partial set of figures/results that does not reveal the main result hierarchy, do not immediately produce a full Results structure. First explain what information is missing, ask focused questions, or recommend that the user upload the study protocol, analysis outline, figure list, or results report.

Step 2 — Identify the study result hierarchy

Determine:

  • what the main result is,
  • what is descriptive setup,
  • what is mechanistic or explanatory support,
  • what is sensitivity or subgroup support,
  • what is validation.
Step 3 — Diagnose the current organization

If a Results draft or figure list exists, assess whether:

  • the section opens with the wrong block,
  • primary findings are buried,
  • supporting analyses are oversized,
  • validation is placed too early or too late,
  • the narrative is figure-by-figure rather than claim-by-claim,
  • discussion language is leaking into Results.
Step 4 — Build the Results section order

Design the most defensible order of result blocks. Typical elements may include:

  • sample/cohort characteristics,
  • data quality or preprocessing summary,
  • primary findings,
  • supportive mechanistic or cross-modal analyses,
  • subgroup or sensitivity analyses,
  • validation results.
Step 5 — Define paragraph/block roles

Specify what each Results subsection should accomplish and what it should not do.

Step 6 — Mark citation-needing statements

For statements that need literature support, add the required citation-support marker and provide a suitable PubMed search query. If the user explicitly says they do not want this feature, omit it.

Show full SKILL.md (604 more words)Show less
Step 7 — Explain the structuring logic

For major ordering choices, explicitly explain:

  • why one block should come before another,
  • why some analyses should be grouped,
  • why some analyses should be downgraded to support rather than lead,
  • and what fragmentation or overinterpretation this prevents.
Step 8 — Flag remaining uncertainty

If critical information is still missing, clearly state what remains uncertain and what additional uploaded materials would improve the structure.

Step 9 — Produce the final structured output

Follow the mandatory output structure below.

Mandatory Output Structure

A. Input Match Check

State whether the provided material is sufficient for high-confidence Results structuring. If not, clearly say what is missing.

B. Core Study and Results Understanding

State your current understanding of:

  • study topic,
  • study design / evidence type,
  • main finding,
  • major supporting analyses,
  • validation status.
C. Main Problems in the Current Results Organization

State the key weaknesses, such as:

  • fragmented order,
  • buried primary result,
  • figure-dump behavior,
  • premature validation,
  • oversized support sections,
  • discussion leakage,
  • weak setup-to-main-result transition.

Provide the recommended section order.

E. Suggested Subsection Roles

State what each Results subsection should accomplish.

F. Citation Support Suggestions

For statements that need support, add the required citation-support marker and provide a corresponding PubMed search query.

G. Structuring Logic Explanation

Explain the major ordering choices and their rationale.

H. Claim Boundary Check

State what the Results structure still must not imply.

I. What Additional Information Would Improve Accuracy

If anything important remains unclear, list the exact missing inputs that would improve the structure. When helpful, recommend uploading the study protocol, figure list, or results report.

Formatting Expectations

  • Use the section headers exactly as above.
  • Keep the structuring logic concrete, not generic.
  • Explain choices in terms of result hierarchy, reader guidance, and avoidance of fragmentation.
  • Do not produce a confident long structure when the result inventory is still unclear.
  • When citation support is needed, add the required citation-support marker and provide PubMed queries.
  • If the user explicitly says they do not want citation-support annotation, omit it.

Hard Rules

  1. Do not invent missing results, figures, subgroups, validations, or mechanistic findings.
  2. Do not build a long Results structure when the input is too incomplete to identify the true result hierarchy.
  3. If the input is insufficient, ask follow-up questions or recommend uploading the study protocol, figure list, or results report.
  4. Do not promote secondary or exploratory analyses into false primary findings.
  5. Do not let the Results section become a figure-by-figure dump without narrative control.
  6. Do not insert Discussion-style interpretation as if it were Results structure.
  7. Do not fabricate references, PMIDs, DOIs, cohort details, validation status, or journal expectations.
  8. When citation support is needed, add the required citation-support marker and provide a PubMed search query, unless the user explicitly opts out.
  9. Always explain the structuring logic.
  10. Do not imply a stronger evidence chain than the existing results support.

What This Skill Should Not Do

This skill should not:

  • act like a generic manuscript organizer from a topic alone,
  • invent a result hierarchy from weak evidence,
  • hide missing study coherence behind polished section headings,
  • overpromote mechanistic support or validation,
  • or ignore the need to request better materials when current input is insufficient.

Quality Standard

A strong output from this skill:

  • correctly identifies the main result hierarchy,
  • orders result blocks coherently,
  • distinguishes setup, main findings, support, and validation,
  • explains the structuring logic clearly,
  • and tells the user when better source materials are needed.

A weak output:

  • produces a fluent but arbitrary section order,
  • invents a narrative from missing results,
  • treats every figure equally,
  • or fails to ask for better inputs when confidence is low.

© aipoch, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 8 other files (references) in awesome-med-research-skills/Academic Writing/results-section-structurer of aipoch/medical-research-skills.

  • SKILL.md
  • eval_report_results-section-structurer_result.json
  • references/citation-support-annotation-rules.md
  • references/clarification-first-rule.md
  • references/hard-rules.md
  • references/logic-reporting-rule.md
  • references/results-boundary-rules.md
  • references/results-ordering-rules.md
  • references/upload-recommendation-rule.md

Open the folder on GitHubat commit 686e09d

Compare with similar skills

Results Section Structurer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Results Section Structurer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Results Section Structurer this skillaipoch/medical-research-skills2k—~3kAutomated safety check: PassMIT
Hypothesis Generationspacering-net/codeg3.9k14 repos~3.6kAutomated safety check: NotesMIT
GitHub Deep Researchbytedance/deer-flow84k4 repos~1.3kAutomated safety check: PassMIT
Nature Paper CardYuan1z0825/nature-skills47k2 repos~2.1kAutomated safety check: PassApache-2.0
Content Research Writerweapp-tailwindcss/weapp-tailwindcss1.9k25 repos~3.5kAutomated safety check: PassMIT
Peer Reviewspacering-net/codeg3.9k17 repos~5.9kAutomated safety check: NotesMIT

Similar skills

  • Hypothesis Generation

    spacering-net/codeg

    Structured hypothesis formulation from observations. An agent skill from spacering-net/codeg.

    3.9k GitHub starsUsed in 14 repos~3.6k tokens
    Research & ScienceAuto-check: notes
  • GitHub Deep Research

    bytedance/deer-flow

    Researches a GitHub repository over four rounds using the GitHub API and web search, then writes a structured markdown report with timeline, metrics and Mermaid diagrams.

    84k GitHub starsUsed in 4 repos~1.3k tokens
    Research & ScienceAuto-check passed
  • Nature Paper Card

    Yuan1z0825/nature-skills

    Builds a structured deep-reading card for one scientific paper, covering methods, how experiments support claims, limitations and research ideas, with a script to prepare the source.

    47k GitHub starsUsed in 2 repos~2.1k tokens
    Research & ScienceAuto-check passed
  • Content Research Writer

    weapp-tailwindcss/weapp-tailwindcss

    Assists in writing high-quality content by conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback on each section.

    1.9k GitHub starsUsed in 25 repos~3.5k tokens
    Research & ScienceAuto-check passed
  • Peer Review

    spacering-net/codeg

    Structured manuscript/grant review with checklist-based evaluation.

    3.9k GitHub starsUsed in 17 repos~5.9k tokens
    Research & ScienceAuto-check: notes
  • Last30days

    mvanhorn/last30days-skill

    Research what people actually say about any topic in the last 30 days.

    64k GitHub stars~7.9k tokensUpdated today
    Research & ScienceAuto-check: notes

More from aipoch/medical-research-skills

All 578 skills in this repo
  • Academic Poster Generator

    aipoch/medical-research-skills

    Complete workflow for generating academic research posters from PDF literature; use when you need to extract paper content from PDFs and produce a LaTeX-based poster…

    2k GitHub stars~2.2k tokensUpdated 22 days ago
    Auto-check passed
  • Diagnostic Study Quality Assessment Quadas

    aipoch/medical-research-skills

    Analyzes clinical diagnostic accuracy studies for bias using the QUADAS-2 tool.

    2k GitHub stars~1.4k tokensUpdated 22 days ago
    Auto-check passed
  • Exploratory Data Analysis

    aipoch/medical-research-skills

    Perform comprehensive exploratory data analysis on scientific data files across 200+ file formats.

    2k GitHub stars~3.7k tokensUpdated 22 days ago
    Auto-check passed
  • Iso Certification

    aipoch/medical-research-skills

    A toolkit for preparing ISO 13485:2016 certification documentation for medical device QMS.

    2k GitHub stars~1.8k tokensUpdated 22 days ago
    Auto-check passed
  • Journal Skills

    aipoch/medical-research-skills

    Recommends target journals for manuscript submission by analyzing the paper topic/abstract and the journal distribution of similar PubMed literature; use when users ask for journal…

    2k GitHub stars~1.7k tokensUpdated 22 days ago
    Auto-check passed
  • Latex Posters

    aipoch/medical-research-skills

    Creates academic-poster writing packages for LaTeX using beamerposter, tikzposter, or baposter.

    2k GitHub stars~1.3k tokensUpdated 22 days ago
    Auto-check passed

Questions about Results Section Structurer

What does Results Section Structurer do?

Organizes biomedical figures, analyses, and result blocks into a clear Results section structure with disciplined narrative ordering and evidence-aware presentation. Results Section Structurer is an agent skill from aipoch/medical-research-skills. Organizes biomedical figures, analyses, and result blocks into a clear Results section structure with disciplined narrative ordering and evidence-aware presentation.

When should I use Results Section Structurer?

Results Section Structurer fits situations like: research & Science work in your project.

How do I install Results Section Structurer in Claude Code?

Run `npx skills add aipoch/medical-research-skills --skill results-section-structurer -a claude-code`. Or copy the skill folder (awesome-med-research-skills/Academic Writing/results-section-structurer in aipoch/medical-research-skills) into .claude/skills/results-section-structurer in your project. Claude Code loads it when a task matches its description.

How do I install Results Section Structurer in Codex?

Run `npx skills add aipoch/medical-research-skills --skill results-section-structurer -a codex`. Or copy the skill folder (awesome-med-research-skills/Academic Writing/results-section-structurer in aipoch/medical-research-skills) into .agents/skills/results-section-structurer in your project. Codex loads it when a task matches its description.

Can I use Results Section Structurer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aipoch/medical-research-skills --skill results-section-structurer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/results-section-structurer, .gemini/skills/results-section-structurer, .github/skills/results-section-structurer and .opencode/skills/results-section-structurer in your project.

What does Results Section Structurer need to run?

SKILL.md names no scripts, command-line tools or credentials: Results Section Structurer is instructions for the agent only.

Does Results Section Structurer access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Results Section Structurer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Results Section Structurer use?

Results Section Structurer is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Results Section Structurer use?

About 3k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.1k tokens, read only when the agent opens those files.

What are the alternatives to Results Section Structurer?

Skills that share tags, products or a category with Results Section Structurer: Hypothesis Generation (spacering-net/codeg, 3.9k stars), GitHub Deep Research (bytedance/deer-flow, 84k stars), Nature Paper Card (Yuan1z0825/nature-skills, 47k stars) and Content Research Writer (weapp-tailwindcss/weapp-tailwindcss, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Results Section Structurer?

aipoch (a GitHub organization) maintains it in aipoch/medical-research-skills, which has 1,978 GitHub stars. The repository holds 578 skills in this directory. The repository was last updated on September 17, 2026.

Source: aipoch/medical-research-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.