rhetorical-discourse-structure

Analyzes argument ordering, discourse markers, and rhetorical devices in text corpora for voice replication.

13|2|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/aaddrick/written-voice-replication --skill rhetorical-discourse-structure-aaddrick
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rhetorical-discourse-structure
Source: https://github.com/aaddrick/written-voice-replication/tree/main/.claude/skills/rhetorical-discourse-structure
Command: npx skills add https://github.com/aaddrick/written-voice-replication --skill rhetorical-discourse-structure-aaddrick

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When replicating an author's writing style, word choice and sentiment alone are not enough — you also need to capture how the author structures arguments, uses discourse markers, and organizes paragraphs. This Skill quantifies those structural patterns from a text corpus and turns them into measurable, replicable constraints. ## Core Features & Use Cases - Argument Ordering Classification: Detects whether an author leads with claims, evidence, dialectical concessions, exploratory weighing, or narrative framing across a corpus. - Discourse Marker Profiling: Counts contrastive, elaborative, inferential, concessive, emphatic, and topic-management markers per 1000 words using Fraser's taxonomy. - Rhetorical Device & Structure Metrics: Measures hedging, rhetorical questions, analogies, concession-contrast pairs, paragraph length distributions, list-to-prose ratios, and summary positioning. - Use Case: Feed a Reddit comment export into the pipeline to produce a discourse structure profile (e.g., dominant evidence-first ordering, high hedging rate) that feeds into a voice replication skill with numeric targets. ## Quick Start Analyze the writing samples in this project for argument ordering patterns, discourse marker usage, and paragraph structure, then write the report to docs/analysis/20-rhetorical-discourse-structure.md.

Frequently Asked Questions about rhetorical-discourse-structure

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

FAQPage Schema
How do I analyze argument structure in a writing corpus?

Classify each text of 3+ sentences by locating the main claim relative to its supporting evidence, then assign one of five ordering patterns: claim-first, evidence-first, dialectical, exploratory, or narrative-embedded. Aggregate the classifications to find the author's dominant pattern.

How to measure discourse marker usage in text?

Use dictionary-based matching against Fraser's taxonomy categories: contrastive, elaborative, inferential, topic-management, concessive, and emphatic markers. Count occurrences with word-boundary regex and report rates per 1000 words, noting that polysemous markers like 'so' and 'well' cannot be disambiguated automatically.

What is the minimum corpus size for discourse structure analysis?

The corpus needs at least 500 words total, with at least 50% of texts containing two or more sentences. Below these thresholds, structural patterns like argument ordering and paragraph habits cannot be measured reliably and the analysis should stop or proceed only with limited scope.

Can discourse marker counting work on non-English text?

No, the marker dictionaries are English-specific, so non-English text invalidates the counts. Translated text is also problematic because discourse markers and argument ordering may reflect the translator's habits rather than the original author's.

Why does hedging detection over-count in technical writing?

Words like 'might', 'could', and 'it seems' reflect genuine epistemic uncertainty in scientific or technical contexts, not a rhetorical habit. When analyzing domain-specific technical corpora, discount hedge frequency against the genre baseline to avoid overstating tentativeness.