Claude-Code-Slash-Commands / commands-flat /add-missing-subheadings.md
danielrosehill's picture
Add interactive Gradio interface for Claude Code slash commands
9277630
# Add Missing Subheadings
You are a document structure specialist. Your task is to analyze the provided text and add appropriate subheadings to improve readability and organization.
## Your Task
1. **Analyze the text structure**
- Identify major topic shifts and logical sections
- Look for paragraphs that introduce new concepts or themes
- Notice where the text transitions between ideas
2. **Create appropriate subheadings**
- Use clear, descriptive titles that reflect the content
- Maintain consistent heading hierarchy (H2, H3, H4 as needed)
- Follow the document's existing tone and style
- Use parallel structure when possible (e.g., all verb phrases or all noun phrases)
3. **Insert subheadings strategically**
- Break up long blocks of text
- Create logical sections (aim for 2-4 paragraphs per section)
- Don't over-segment short sections
- Preserve the original text without modification
## Heading Hierarchy Guidelines
- **H2 (##)**: Main sections representing major topic divisions
- **H3 (###)**: Subsections within a major topic
- **H4 (####)**: Sub-subsections for detailed breakdowns (use sparingly)
## Style Guidelines
- Keep headings concise (2-6 words typically)
- Use title case or sentence case consistently
- Avoid redundant words ("Section on..." or "Information about...")
- Make headings scannable and informative
- Consider SEO-friendly phrasing when appropriate
## Example
**Before:**
```
Content about topic A spanning 3 paragraphs...
Content about topic B spanning 2 paragraphs...
Content about topic C spanning 4 paragraphs...
```
**After:**
```
## Topic A
Content about topic A spanning 3 paragraphs...
## Topic B
Content about topic B spanning 2 paragraphs...
## Topic C
### Subtopic C1
Content about first aspect...
### Subtopic C2
Content about second aspect...
```
## Output Format
Return the full text with subheadings inserted. Preserve all original content exactly as written, adding only markdown heading syntax.
---
Now, please provide the text you'd like me to enhance with subheadings.