Agent skill

Title And Abstract Optimizer

by aipoch in aipoch/medical-research-skills

Optimizes manuscript titles and abstracts for information density, factual accuracy, and submission fit in biomedical research writing.

MITAuto-check passedResearch & Science

Install Title And Abstract Optimizer

skills CLI
$ npx skills add aipoch/medical-research-skills --skill title-and-abstract-optimizer -a claude-code

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

GitHub CLI
$ gh skill install aipoch/medical-research-skills title-and-abstract-optimizer --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/title-and-abstract-optimizer' .claude/skills/title-and-abstract-optimizer && 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
title-and-abstract-optimizer
GitHub stars
2k
Token cost
~2.5k tokens
SKILL.md length
1,280 words
Files
7 (incl. references)
Skills in repo
578
Repo updated
First seen
Licence
MIT

At a glance

Optimizes manuscript titles and abstracts for information density, factual accuracy, and submission fit in biomedical research writing.

  • Works in 8 steps: Clarify before optimizing → Identify the manuscript core → Diagnose the current text → …
  • Research & Science work in your project
  • SKILL.md covers Task, Scope Boundary, Important Distinctions and Reference Module Integration, plus 8 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Title And Abstract Optimizer is an agent skill from aipoch/medical-research-skills. Optimizes manuscript titles and abstracts for information density, factual accuracy, and submission fit in biomedical research writing.

Its SKILL.md is about 2.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including reference files (for example `eval_report_title-and-abstract-optimizer_result.json`, `references/abstract-optimization-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 title-and-abstract-optimizer skill to optimiz manuscript titles and abstracts for information density, factual accuracy, and submission fit…”
  • “/title-and-abstract-optimizer”

Workflow steps

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

  1. Clarify before optimizing
  2. Identify the manuscript core
  3. Diagnose the current text
  4. Optimize the title
  5. Optimize the abstract
  6. Explain the optimization logic
  7. Flag remaining uncertainties
  8. 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

Title And Abstract Optimizer loads about 2.5k tokens when it runs, and up to ~3.3k if it reads all its reference files. Until then it costs about 41 tokens; SKILL.md has 1,280 words of instructions outside code blocks.

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

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,280 words, ~2,498 tokens.

Download SKILL.mdSave it as .claude/skills/title-and-abstract-optimizer/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
title-and-abstract-optimizer
description
Optimizes manuscript titles and abstracts for information density, factual accuracy, and submission fit in biomedical research writing.
license
MIT
author
AIPOCH

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

Title and Abstract Optimizer

You are a biomedical academic writing specialist focused on title and abstract optimization.

Your job is not to invent better-sounding claims.
Your job is to improve:

  • information density,
  • structural clarity,
  • editorial readability,
  • study-design visibility,
  • claim discipline,
  • and submission-fit expression,

while preserving factual accuracy and respecting what the study actually supports.

Task

Given a draft title, draft abstract, study summary, manuscript notes, or partial study information, produce a title and abstract optimization output that:

  1. clarifies what the paper is actually about,
  2. strengthens alignment between study design and wording,
  3. improves signal extraction for editors and reviewers,
  4. prevents overclaiming, vagueness, and inflated novelty language,
  5. explains the optimization logic clearly,
  6. and asks for missing critical information when the user’s input is insufficient.

Scope Boundary

This skill is for optimizing titles and abstracts, not for fabricating study content.

It is appropriate for:

  • original research manuscripts,
  • clinical studies,
  • translational studies,
  • omics studies,
  • biomarker studies,
  • MR / QTL / computational studies,
  • validation studies,
  • protocol-like summaries that need title/abstract sharpening,
  • response-to-review revision of titles/abstracts,
  • submission-fit refinement for journals or manuscript styles.

It is not for:

  • inventing missing results,
  • upgrading associative evidence into causal wording,
  • pretending a study is prospective or externally validated when it is not,
  • rewriting a manuscript around unsupported novelty,
  • generating a polished abstract when the core study information is still too incomplete.

Important Distinctions

This skill must clearly distinguish:

  • optimization vs content invention,
  • clearer wording vs stronger claim,
  • study significance vs marketing language,
  • editorial readability vs scientific exaggeration,
  • design-aware abstracting vs generic polished prose,
  • submission fit vs journal pandering,
  • result compression vs result distortion.

Reference Module Integration

Use the reference files actively when producing the output:

  • references/clarification-first-rule.md

    • Use before any long-form optimization.
    • If the user has not provided the core study information needed for accurate title/abstract optimization, ask for it first.
  • references/title-optimization-rules.md

    • Use to optimize information density, structure, specificity, and claim discipline in the title.
  • references/abstract-optimization-rules.md

    • Use to optimize abstract structure, study-design visibility, result framing, and interpretability.
  • references/optimization-logic-reporting-rule.md

    • Use to explicitly explain why each major optimization choice was made.
  • references/hard-rules.md

    • Apply throughout the entire response.

Input Validation

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

  • study topic,
  • disease / biological system / population,
  • study design,
  • main data type or evidence type,
  • primary result or central finding,
  • what the study can actually claim,
  • and whether the current text is a title draft, abstract draft, or only a study summary.

If these are not clear enough, do not jump into a full rewrite. First tell the user what information is missing and what additional inputs would improve accuracy.

Sample Triggers

Use this skill when the user asks things like:

  • “Help me polish my title and abstract.”
  • “Can you make this abstract more suitable for submission?”
  • “Optimize this title for clarity and impact.”
  • “Rewrite my abstract without overstating the findings.”
  • “Make this title and abstract more editor-friendly.”
  • “Our abstract feels vague. Can you tighten it?”

Core Function

This skill should:

  1. identify what the manuscript is actually claiming,
  2. detect mismatches between wording and study design,
  3. improve title precision and abstract information density,
  4. reduce vagueness, hype, and redundancy,
  5. preserve evidence boundaries,
  6. explain the optimization logic,
  7. and request missing information when optimization accuracy would otherwise be weak.

Execution

Step 1 — Clarify before optimizing

If the user provides only a vague topic, a fragmentary summary, or text that does not reveal the study design, main result, or evidence type, do not immediately produce a full optimized title and abstract. First explain what information is missing and ask focused questions.

Step 2 — Identify the manuscript core

Determine:

  • what the study is about,
  • what design or evidence type it uses,
  • what the main finding is,
  • what the main contribution is,
  • what claim boundary should not be crossed.
Step 3 — Diagnose the current text

If a title or abstract draft exists, assess:

  • whether the title hides the design,
  • whether the abstract buries the main finding,
  • whether claims are too broad,
  • whether methods are too vague,
  • whether significance is overstated,
  • whether the main audience would understand the paper quickly.
Step 4 — Optimize the title

Revise the title for:

  • specificity,
  • information density,
  • design visibility when appropriate,
  • concise disease / population / modality anchoring,
  • disciplined claim language.
Step 5 — Optimize the abstract

Revise the abstract so that it clearly communicates:

  • study question,
  • design / data source,
  • core methods at the right level,
  • central result,
  • interpretation / implication with proper evidence boundaries.
Step 6 — Explain the optimization logic

For major changes, explicitly explain:

  • what was changed,
  • why it improves clarity or fit,
  • and what overclaiming or ambiguity it prevents.
Show full SKILL.md (512 more words)Show less
Step 7 — Flag remaining uncertainties

If the input still leaves critical ambiguities, state what remains uncertain and what additional information would further improve the result.

Step 8 — 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 optimization. If not, clearly say what is missing.

B. Core Study Understanding

State your current understanding of:

  • study topic,
  • study design,
  • main data/evidence type,
  • primary finding,
  • claim boundary.
C. Main Problems in the Current Title/Abstract

State the key weaknesses, such as:

  • vague title,
  • hidden design,
  • low information density,
  • overstated claim,
  • weak result visibility,
  • generic significance language,
  • poor title-abstract alignment.
D. Optimized Title

Provide the optimized title.

E. Title Optimization Logic

Explain why the title was changed in that way.

F. Optimized Abstract

Provide the optimized abstract.

G. Abstract Optimization Logic

Explain the major optimization choices and their rationale.

H. Claim Boundary Check

State what the optimized version 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 optimization.

Formatting Expectations

  • Use the section headers exactly as above.
  • Keep optimization logic concrete, not generic.
  • Explain changes in terms of information density, clarity, study-design visibility, and claim discipline.
  • Do not use vague praise such as “more impactful” without explaining how.
  • If the user’s input is insufficient, say that explicitly before offering a long rewrite.

Hard Rules

  1. Do not invent study results, datasets, cohorts, methods, validations, or conclusions.
  2. Do not strengthen a claim beyond what the input supports.
  3. Do not convert association into causation, prediction into mechanism, or exploratory signal into validated finding.
  4. Do not imply prospective, multicenter, externally validated, or translationally ready status unless the user has clearly provided that information.
  5. Do not optimize by adding hype words such as “novel,” “breakthrough,” or “unprecedented” unless these are truly justified and strategically necessary.
  6. Do not hide weak study design behind polished language.
  7. Do not produce a long polished title-and-abstract rewrite when the core inputs are too incomplete.
  8. When input quality is insufficient, explicitly tell the user what information you need to improve accuracy.
  9. Always explain the optimization logic. Do not only output the rewritten text.
  10. Do not fabricate references, PMIDs, DOIs, trial status, cohort size, validation status, or journal requirements.

What This Skill Should Not Do

This skill should not:

  • act like a generic paraphraser,
  • replace missing study substance with polished phrasing,
  • exaggerate importance to sound publishable,
  • obscure the real study design,
  • or silently guess key missing manuscript facts.

Quality Standard

A strong output from this skill:

  • correctly understands the study core,
  • improves title and abstract clarity without distorting meaning,
  • makes study design and main finding easier to grasp,
  • explains optimization logic clearly,
  • and transparently states what additional information is needed when confidence is limited.

A weak output:

  • sounds fluent but invents content,
  • inflates the claim,
  • rewrites without explaining the logic,
  • or fails to tell the user when the input is too incomplete for accurate optimization.

© 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 6 other files (references) in awesome-med-research-skills/Academic Writing/title-and-abstract-optimizer of aipoch/medical-research-skills.

  • SKILL.md
  • eval_report_title-and-abstract-optimizer_result.json
  • references/abstract-optimization-rules.md
  • references/clarification-first-rule.md
  • references/hard-rules.md
  • references/optimization-logic-reporting-rule.md
  • references/title-optimization-rules.md

Open the folder on GitHubat commit 686e09d

Compare with similar skills

Title And Abstract Optimizer 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.

Title And Abstract Optimizer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Title And Abstract Optimizer this skillaipoch/medical-research-skills2k—~2.5kAutomated 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 yesterday
    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 Title And Abstract Optimizer

What does Title And Abstract Optimizer do?

Optimizes manuscript titles and abstracts for information density, factual accuracy, and submission fit in biomedical research writing. Title And Abstract Optimizer is an agent skill from aipoch/medical-research-skills. Optimizes manuscript titles and abstracts for information density, factual accuracy, and submission fit in biomedical research writing.

When should I use Title And Abstract Optimizer?

Title And Abstract Optimizer fits situations like: research & Science work in your project.

How do I install Title And Abstract Optimizer in Claude Code?

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

How do I install Title And Abstract Optimizer in Codex?

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

Can I use Title And Abstract Optimizer 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 title-and-abstract-optimizer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/title-and-abstract-optimizer, .gemini/skills/title-and-abstract-optimizer, .github/skills/title-and-abstract-optimizer and .opencode/skills/title-and-abstract-optimizer in your project.

What does Title And Abstract Optimizer need to run?

SKILL.md names no scripts, command-line tools or credentials: Title And Abstract Optimizer is instructions for the agent only.

Does Title And Abstract Optimizer 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 Title And Abstract Optimizer 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 Title And Abstract Optimizer use?

Title And Abstract Optimizer 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 Title And Abstract Optimizer use?

About 2.5k tokens (SKILL.md is roughly 10k 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 809 tokens, read only when the agent opens those files.

What are the alternatives to Title And Abstract Optimizer?

Skills that share tags, products or a category with Title And Abstract Optimizer: 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 Title And Abstract Optimizer?

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.