cognitive-rhythm-writing

Design pacing in explanatory Japanese writing by managing cognitive rhythm and unresolved tension.

Updated May 12, 2026
One-click install
npx skills add https://github.com/mtk177a/skills --skill cognitive-rhythm-writing-mtk177a
Or copy as Structured Prompt for Agentβ–Ό
Please help me install this Agent Skill.
Skill: cognitive-rhythm-writing
Source: https://github.com/mtk177a/skills/tree/main/skills/cognitive-rhythm-writing
Command: npx skills add https://github.com/mtk177a/skills --skill cognitive-rhythm-writing-mtk177a

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Dense Japanese explanatory writing often reads as flat and boring because every paragraph is written in the same cognitive mode. This Skill treats pacing not as decoration but as deliberate switching of the reader's cognitive mode (observation, hesitation, assertion, re-observation) and as management of unresolved tension, so readers always have a reason to keep reading. ## Core Features & Use Cases - Sentence and paragraph rhythm design: Defines beat patterns (short setup, long flow, short stop), paragraph density waveforms, and alternation between assertion and hesitation. - Tension and meta-prose control: Requires at least one open question at all times, bans narration of the writing process itself, and provides a topic test to distinguish productive looseness from deletable filler. - Mechanical post-draft inspection: A five-step checklist covering topic tests, device-vocabulary leakage, tension ledgers, beat checks, and boundary checks, plus a symptom-to-prescription table for diagnosing flat drafts. - Use Case: When revising a technically correct but tedious Japanese article or chapter, apply this Skill together with japanese-tech-writing to add pacing using only material from the subject matter, without shortening away necessary context. ## Quick Start Revise this flat Japanese technical chapter so it has cognitive rhythm, reading the japanese-tech-writing Skill first and preserving all necessary context.

Frequently Asked Questions about cognitive-rhythm-writing

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

FAQPage Schema
How do I make dense Japanese technical writing less boring?β–Ό

Add pacing by switching the reader's cognitive mode between observation, hesitation, assertion, and re-observation rather than changing information volume. Keep at least one unresolved question open at all times and alternate dense paragraphs with sparse ones.

How do I diagnose a flat but correct Japanese article?β–Ό

Use the symptom-to-prescription table: uniform paragraph tone means missing sentence beats, no reading momentum means no unresolved tension, and cold theory sections mean theory appeared before the reader's sense of discomfort. Then apply the five-step inspection checklist.

Does cognitive-rhythm-writing require other Skills to work?β–Ό

Yes, it requires the companion japanese-tech-writing Skill. If that Skill is missing, it stops without applying any rules and instructs the user to install both Skills with a single apm install command.

What is the difference between looseness and filler in Japanese prose?β–Ό

The test is whether a sentence updates the situation or the document. Sentences conveying events, data, or the narrator's judgment state are acceptable looseness; sentences only describing the chapter's progress or appearance are filler to delete.

Can I shorten sentences to create rhythm in Japanese writing?β–Ό

No, cutting necessary context such as scope, comparison axes, or unresolved facts to make sentences short is treated as omission, not pacing. Density edits are allowed only on top of already-shared context.