paper-self-review

Diagnose research paper paragraphs across five axes and direct revisions.

36|1|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/jiahao-shao1/sjh-skills --skill paper-self-review-jiahao-shao1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: paper-self-review
Source: https://github.com/jiahao-shao1/sjh-skills/tree/main/skills/paper-self-review
Command: npx skills add https://github.com/jiahao-shao1/sjh-skills --skill paper-self-review-jiahao-shao1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a deterministic revision loop for research paper paragraphs by diagnosing v1 issues (logic gaps, repetition, detail leakage, framing errors, and reader-orientation failures) and guiding a v2 revision direction. It does not generate the first draft.

Core Features & Use Cases

  • Five-axis self-check: Logic, Expression, Detail, Framing, and Reader Orientation.
  • Pre-flight: extract the paragraph's single task to ensure alignment.
  • Stepwise diagnostics: returns a single task, each axis issue, and a concrete revision direction.
  • Anti-pattern awareness and structured guidance to improve clarity and flow.

Quick Start

Paste a paragraph and ask for a five-axis diagnosis to receive a structured revision direction.

Frequently Asked Questions about paper-self-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a structured self-review on a research paper paragraph?

To perform a structured self-review on a research paper paragraph, paste the text into the tool to receive a five-axis diagnostic covering Logic, Expression, Detail, Framing, and Reader Orientation, along with a concrete revision direction.

What is the five-axis framework for academic writing revision?

The five-axis framework for academic writing revision evaluates a paragraph's Logic, Expression, Detail, Framing, and Reader Orientation to surface specific anti-patterns and provide actionable guidance for improving clarity and flow.

Can I use this self-review tool to generate a first draft for my paper?

No, this self-review tool does not generate first drafts. It provides a deterministic revision loop by diagnosing existing v1 paragraph issues and guiding a v2 revision direction for standalone paragraphs in intro, method, or discussion sections.

How do I diagnose logic gaps and framing errors in my research paragraph?

You diagnose logic gaps and framing errors in a research paragraph by submitting the text for a stepwise diagnostic, which extracts the paragraph's single task and identifies specific issues across five axes, returning a targeted revision direction.

What is the best way to improve reader orientation in a method section paragraph?

The best way to improve reader orientation in a method section paragraph is to apply a five-axis self-check, which identifies reader-orientation failures and provides structured guidance to align the text with the paragraph's single extracted task.

Are there limitations to using a five-axis paragraph analysis for academic writing?

A limitation of five-axis paragraph analysis is that it applies only to standalone paragraphs in intro, method, or discussion sections, requiring an existing draft to diagnose rather than generating the initial text.