check-articulation

Analyze documents for articulation gaps using a 5W framework.

4|1|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/hisazumi/paper-review-skills --skill check-articulation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: check-articulation
Source: https://github.com/hisazumi/paper-review-skills/tree/main/skills/check-articulation
Command: npx skills add https://github.com/hisazumi/paper-review-skills --skill check-articulation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps writers identify articulation gaps—where the author knows something but hasn’t explained it clearly—using a structured 5W framework, and it provides concrete, ready-to-use improvement suggestions.

Core Features & Use Cases

  • 5W gap detection: analyzes WHAT, WHY, HOW, WHEN, and Limits to surface missing explanations.
  • Concrete improvements: returns copy-paste-ready text for each gap.
  • Flexible input: works with common document types (TeX/LaTeX, Markdown, Word, PDF, TXT) and supports targeted focus via --section and --focus.

Quick Start

  • Use the skill to scan a document: /check-articulation path/to/document.md
  • Focus on a specific section: /check-articulation paper.tex --section "Chapter 3" --focus why
  • Run in detection-only mode: /check-articulation paper.tex --check-only

Frequently Asked Questions about check-articulation

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

FAQPage Schema
How do I find articulation gaps in my document?

To find articulation gaps in a document, you can scan it using a 5W framework that detects missing WHAT, WHY, HOW, WHEN, and Limits explanations. The skill analyzes your text and outputs a structured report with quotes, severity, and copy-paste-ready edits.

Can I check articulation gaps in a PDF or LaTeX file?

Yes, you can check articulation gaps in PDF, LaTeX, Markdown, Word, and TXT files. The skill accepts these common document formats directly and analyzes them to locate missing explanations using the 5W framework.

How do I review only one section of my paper for missing explanations?

To review only one section for missing explanations, use the --section switch followed by the section name. You can also combine it with the --focus switch to target a specific 5W area like why or how.

What is the best way to detect writing issues without generating automatic edits?

The best way to detect writing issues without generating automatic edits is to run the skill in detection-only mode using the --check-only switch. This outputs a structured gap report with quotes, locations, and severity without providing copy-paste-ready text.

What are articulation gaps and how do I fix them in my writing?

Articulation gaps occur when an author knows something but has not explained it clearly in the text. You fix them by analyzing the document with a 5W framework and applying concrete, copy-paste-ready improvement suggestions to fill the missing explanations.

Are there limitations to using an automated document review for articulation gaps?

Automated document review for articulation gaps relies on a 5W framework to identify missing explanations, but it may not catch nuanced domain-specific context. Use the --check-only mode to review detected gaps manually before applying the generated edits.