introduction-language-flow-reviser

Revise complete English research-paper Introduction sections using a p3-derived language-and-writing checklist for verb tense choices, sentence linkage, tran...

Security Scan

The skill is internally consistent with its stated purpose: an instruction-only writing/revision assistant that reads an Introduction (from message or file), applies a local checklist, and writes two Markdown outputs; it requests no credentials, installs nothing, and does not contact external endpoints.

Purpose & Capability

The name and description match the runtime instructions and included checklist. The skill only requires reading the input Introduction and the local checklist file; producing two Markdown outputs is coherent with a reviser tool.

Instruction Scope

SKILL.md confines actions to reading the user's Introduction (from message or file) and the bundled checklist, performing stepwise edits, recording a method report, and saving two Markdown files. It does not instruct reading unrelated system files, accessing network endpoints, or using undeclared environment variables.

Install Mechanism

No install spec and no code files—this is instruction-only. Nothing is downloaded or written to disk beyond the expected output files (method report and revised document).

Credentials

The skill declares no required environment variables, credentials, or config paths. The requested filesystem writes (saving outputs beside the input or in the working directory) are proportional to the stated purpose.

Persistence & Privilege

always is false and the skill does not request persistent system-wide privileges or modify other skills. Its filesystem writes are limited to user-facing outputs and are consistent with its function.

Assessment

This skill is an instruction-only Writing Reviser that will read the Introduction you provide (either pasted into the prompt or supplied as a file) and produce two Markdown files (a method report and a revised Introduction) in the working directory or beside the input file. It requires no credentials, installs nothing, and does not call external endpoints. Before installing or running it, consider: (1) the agent platform may require permission to read/write files—granting that permission lets the skill write the two output files; (2) the method report will include drafts and examples that may reproduce your input text, so avoid submitting highly sensitive or unpublished data if you have confidentiality concerns; (3) review outputs carefully to ensure no unintended changes to claims/citations (the skill includes explicit constraints against inventing findings but human review is recommended). Overall the skill appears coherent and proportionate to its stated purpose.

Overview

Use this skill to revise the full English text of a research-paper Introduction through the language and writing-skills checks derived from p3.txt: verb tense choices, sentence-to-sentence linkage, transition signals, passive/active choices, and paragraphing. Preserve the original research content, citations, claims, paragraph sequence when possible, and discipline-specific terminology while improving readability, flow, tense accuracy, and communicative precision.

Before revising, read references/language-flow-checklist.md. It contains the p3-derived checklist, decision rules, signal categories, paragraphing guidance, and example transformations.

Required Outputs

Always save two Markdown files unless the user explicitly asks for different filenames or formats:

1. Method report: if the input has a filename, save <stem>-language-flow-method.md; otherwise save introduction-language-flow-method.md.
2. Complete revised document: if the input has a filename, save <stem>-language-flow-revised.md; otherwise save introduction-language-flow-revised.md.

Save outputs beside the input file when the Introduction comes from a file. If the Introduction comes from the prompt, save outputs in the current working directory.

Workflow

1. Read the complete Introduction text from the user's message or file. If no Introduction text is available, ask for it.
2. Preserve structural units: title or heading, paragraph breaks, citations, author names, numbers, units, abbreviations, formulas, quotations, reference markers, and named methods.
3. Create a diagnostic map of the original Introduction: paragraph function, key claims, current tense patterns, linkage problems, voice choices, and paragraph-length or topic-focus issues.
4. Apply the checklist in references/language-flow-checklist.md one step at a time. At each step, revise the full draft produced by the previous step, but make only edits justified by the current step.
5. After every step, record the step result and reasons in the method report. Include the full draft after that step, not only isolated sentence examples, unless the Introduction is extremely long; in that case, include every changed paragraph and clearly mark unchanged paragraphs.
6. Include rich examples for every step in the method report. Prefer examples adapted to the user's topic and sentence patterns when possible; otherwise use general research-writing examples. Label examples as examples, not as claims about the user's study.
7. After the final step, run a consistency pass comparing original and revised text for meaning, evidence strength, tense, modality, citations, numbers, terminology, paragraph order, and claim ownership.
8. Write the complete revised document as clean prose only. Do not include the report, checklist, examples, or commentary in the revised-document file.

Method Report Structure

Use this structure for the method report:

# Introduction Language Flow Revision Method

## Source Handling
- Input source:
- Output files:
- Preservation notes:

## Original Diagnostic Map
| Paragraph | Main function | Tense/flow/voice/paragraphing notes |
|---|---|---|

## Step 1: Preserve Content and Diagnose Language Flow
### Checks Applied
### Draft After This Step
### Modification Reasons
### Examples

## Step 2: Revise Verb Tense Choices
### Checks Applied
### Draft After This Step
### Modification Reasons
### Examples

## Step 3: Strengthen Sentence-to-Sentence Linkage
### Checks Applied
### Draft After This Step
### Modification Reasons
### Examples

## Step 4: Correct Transition Signals and Logical Relations
### Checks Applied
### Draft After This Step
### Modification Reasons
### Examples

## Step 5: Refine Passive/Active and Subject Choices
### Checks Applied
### Draft After This Step
### Modification Reasons
### Examples

## Step 6: Improve Paragraphing and Entry Sentences
### Checks Applied
### Draft After This Step
### Modification Reasons
### Examples

## Step 7: Integrate Final Flow and Consistency
### Checks Applied
### Draft After This Step
### Modification Reasons
### Examples

## Final Verification
- Meaning preserved:
- Claims/citations preserved:
- Tense choices justified:
- Linkage and signals coherent:
- Voice and claim ownership clear:
- Paragraph structure reader-friendly:
- Remaining issues:

In Modification Reasons, identify the paragraph or sentence changed, the language-flow problem addressed, and why the edit follows the current step. If a step requires no substantive edit, keep the previous draft under Draft After This Step and explain why no change was made.

Revision Constraints

• Do not invent findings, citations, dates, statistics, methods, advantages, limitations, novelty claims, or causal relations.
• Do not change tense randomly. Treat tense as a meaning choice: past simple for study-bound findings, present simple for established facts or current paper statements, and present perfect for research trends or gaps with current relevance.
• Preserve modal strength and hedging. Do not turn may, might, could, suggests, or appears into stronger claims.
• Preserve citation placement unless moving a citation is necessary to keep it attached to the supported claim.
• Avoid overusing transition words. Prefer repetition linkage or clear pro-forms when they create smoother flow.
• Do not use ambiguous pronouns or pro-forms such as this, these, it, or they unless the referent is clear.
• Keep we and our referents stable. If we shifts from the paper's authors to the field or people generally, revise for clarity.
• Prefer non-human grammatical subjects such as this study, this paper, the present work, or Section 2 when they improve ownership and style.
• Keep each paragraph focused on one main function. Split, merge, or reorder sentences only when necessary for a reader-friendly Introduction.

Quality Checks

Before finalizing, verify that:

• The method report contains all seven steps, with a draft, reasons, and examples for each step.
• The revised-document file contains only the final revised Introduction.
• All tense changes are explained by meaning, not by grammar alone.
• Sentence links are explicit through overlap, pro-forms, semicolons, or accurate signals.
• Transition signals match their logical function: cause, result, contrast/difference, unexpectedness, addition/listing, or topic transition.
• Passive, active, and non-human subject choices are stylistically and communicatively justified.
• Paragraphs have clear entry sentences and one dominant function.
• The two Markdown files exist at the required paths.