bullet
Analyze bullet point lists using cognitive research to improve recall and scanning. Get actionable feedback on length, hierarchy, and structure with a 0-100 score.
Instructions
Validate and improve bullet point lists using evidence-based cognitive research.
This tool analyzes bullet lists against scientifically-validated principles for optimal recall, scanning efficiency, and comprehension. Use it to ensure your summaries follow best practices.
INPUT MODES:
Flat mode: Use "items" for simple lists (3-7 items recommended)
Sectioned mode: Use "sections" for long documents with multiple topics/chapters
Each section has its own title and items array
The 3-7 item rule applies PER SECTION, allowing unlimited total content
WHEN TO USE:
Before finalizing any bullet list summary
When creating documentation, reports, or reference materials
To score existing bullet content against research standards
For guidance on improving list structure
KEY PRINCIPLES ENFORCED:
List Length (3-7 items per section, 5 optimal): Working memory limits mean more items decrease recall
Hierarchy (max 2 levels): Breadth over depth for better comprehension
Serial Position: Place critical info first and last (U-shaped recall curve)
Line Length (45-75 chars, 66 optimal): Typography research on readability
Parallel Structure: Consistent grammar enables faster scanning
First Two Words: Critical for reader fixation and scanning decisions
CONTEXT AWARENESS:
document: Optimizes for scanning and reference (default)
presentation: Warns that visuals may be more effective (43% more persuasive per research)
reference: Optimizes for quick lookup
Per-section context override supported in sectioned mode
SCORING:
0-100 scale with letter grades (A/B/C/D/F)
Per-rule breakdown with research citations
Per-section breakdown in sectioned mode
Actionable improvement suggestions ranked by impact
Returns JSON with score, grade, issues, and top improvements.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | Title/heading for the bullet list (e.g., "Email Thread Summary") | |
| description | Yes | Brief summary or context about what the bullets cover | |
| intro | Yes | Introductory phrase before the bullets (e.g., "Here are the main topics:") | |
| items | No | Array of bullet items to validate (flat mode). Use this OR sections, not both. | |
| sections | No | For long documents, group bullets into sections. Each section is validated separately. Use this OR items, not both. | |
| context | No | Usage context affects recommendations. Default: document. In sectioned mode, this is the default context (sections can override). |