SKILL.md
$27
Element
Purpose
Items
Single column; stacked vertically
Per item
Title, optional metadata (date, author), excerpt, link
Spacing
Consistent gaps; dividers or alternating background
Density
Compact (docs) vs relaxed (blog)
List Variants
Variant
Use
Simple list
Title + link; minimal (nav, TOC)
Rich list
Title, excerpt, date, author
Table-like
Columns for metadata (date, status)
With thumbnail
Small image + text
Best Practices
Principle
Practice
Scannable
Clear titles; consistent hierarchy
Compact
Less vertical space than grid
Link area
Full row or title clickable
Metadata
Date, author, category; secondary styling
F-Pattern
Users read top-left first, then scan left column. Place primary content (titles) left-aligned; metadata secondary.
Infinite Scroll
If using infinite scroll for list (e.g., blog index, search results): crawlers cannot access content loaded on scroll. Provide paginated component pages or use traditional pagination for SEO-critical content. See site-crawlability for search-friendly infinite scroll implementation.
Responsive
- Mobile: Single column; full-width items
- Touch targets: ≥44×44px for touchable rows
- Truncation: Long titles; ellipsis or wrap by design
Related Skills
- site-crawlability: Infinite scroll SEO; paginated component pages; search-friendly implementation
- grid: Grid vs list; when to use each
- carousel: Carousel for slides; when list is too long for space
- card: Card in list (e.g., blog with thumbnail)
- toc-generator: TOC as list; jump links
- blog-page-generator: Blog index list
- article-page-generator: Article list format
- docs-page-generator: Documentation list