writing-reviewer

Evaluate document argument logic, evidence quality, and writing clarity.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/francojc/dotfiles --skill writing-reviewer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-reviewer
Source: https://github.com/francojc/dotfiles/tree/main/.pi/agent/skills/writing-reviewer
Command: npx skills add https://github.com/francojc/dotfiles --skill writing-reviewer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps researchers, writers, and editors perform rigorous, objective critiques of draft documents. It targets flaws in argument structure, evidence quality, methodological soundness, and writing clarity, and it produces a structured review plus a concrete revision task list to guide revisions.

Core Features & Use Cases

  • Thorough critique of argument logic, evidence quality, and writing clarity.
  • Structured review that identifies major and minor concerns and generates actionable feedback.
  • Revision tasks: produces a concrete task list to guide authors in targeted rewrites and improvements.
  • Use case: ideal for evaluating conference submissions, journal articles, proposals, or literature reviews to improve rigor and clarity.

Quick Start

Provide the document path or section keyword and I will generate a structured peer review with a revision task list.

Frequently Asked Questions about writing-reviewer

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

FAQPage Schema
How do I get structured peer review feedback on a draft paper?

To get structured peer review, provide your draft document or section keyword to generate a critique evaluating argument logic, evidence quality, and writing clarity. The review returns delineated major and minor concerns plus a concrete list of revision tasks.

Can I critique evidence quality and citation usage in a literature review?

Yes, you can critique evidence quality and citation usage in a literature review. The review targets flaws in methodological soundness and supports citation-backed critique using literature databases to evaluate your sources.

What is the best way to generate actionable revision tasks for a journal article?

The best way to generate actionable revision tasks is running a rigorous critique on the journal article. This evaluates argument structure and writing clarity, producing a structured review with a concrete task list to guide targeted rewrites.

Does this peer review approach work for research proposals and conference submissions?

Yes, this peer review approach works for research proposals and conference submissions. It performs objective critiques evaluating argument logic, methodological soundness, and clarity to improve rigor across drafts, full papers, and proposals.

How do I identify major and minor concerns in my writing before submission?

You identify major and minor concerns by running a structured peer review on the document. The critique rigorously evaluates argument structure, evidence quality, and clarity, returning a review with concerns clearly delineated by severity.

When should I not rely on an automated critique for document revision?

You should not rely on an automated critique when your document lacks a complete argument structure or sufficient evidence to evaluate. The review requires a draft document with substantive content to assess logic and generate targeted revision tasks.