Skills infocard

Create editorial-style information cards using HTML/CSS in Markdown. Best for knowledge summaries, data highlights, event announcements, and single-topic content cards with magazine-quality typography.

install
source · Clone the upstream repo
git clone https://github.com/markdown-viewer/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/markdown-viewer/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/infocard" ~/.claude/skills/markdown-viewer-skills-infocard && rm -rf "$T"
manifest: infocard/SKILL.md
source content

Infocard Generator

Quick Start: Analyze content (density × structure × mood) → Auto-sense tone for color palette → Pick a layout skeleton → Embed HTML directly in Markdown with

<style scoped>
.

Critical Rules

Rule 1: Direct HTML Embedding

IMPORTANT: Write info cards as direct HTML in Markdown. NEVER use code blocks (

```html
). The HTML should be embedded directly in the document without any fencing.

Rule 2: No Empty Lines in HTML Structure

CRITICAL: Do NOT add any empty lines within the HTML info card structure. Keep the entire HTML block continuous to prevent parsing errors.

Rule 3: Content Analysis Before Layout

REQUIRED: Analyze content along three dimensions before designing:

Density (determines breathing rhythm):

DensityContent VolumeVisual Treatment
Low≤ 50 words core"Big-character" composition. One oversized element dominates. Generous whitespace.
Medium50–200 wordsHero + supporting panels. 2–3 main blocks with clear hierarchy.
High200+ wordsAsymmetric multi-column grids. Primary/secondary/supporting blocks. Never equal-weight tiles.

Structure (determines layout geometry):

StructureSignalLayout Pattern
Single pointOne core conceptOne anchor element dominates, rest recedes
ContrastA vs B, old vs newSplit panel, two poles
HierarchyLayers build on each otherStacked modules, pyramid
FlowSequential stepsVertical cascade, numbered items
RadialCore + derivativesHub with surrounding panels
ParallelMultiple equal conceptsAsymmetric grid (never equal columns)

Mood (determines color temperature):

MoodVisual Feel
ReflectiveMore whitespace, serif-heavy, lower contrast
SharpStrong contrast, bold type, vivid accent
WarmEarth tones, rounded feel, gentle rhythm
TechnicalMonospace accents, grid-like density

Rule 4: Tone Sensing

REQUIRED: Auto-select color palette based on content topic. Scan content keywords and match the closest tone:

Content ToneBackgroundAccentTrigger Keywords
Philosophical
#FAF8F4
#7C6853
cognition, thinking, meaning, philosophy, essence
Technical
#F5F7FA
#3D5A80
architecture, algorithm, system, API, code
Literary
#FBF9F1
#6B4E3D
story, narrative, writing, poetry, character
Scientific
#F4F8F6
#2D6A4F
experiment, data, research, paper, discovery
Business
#F4F3F0
#2D6A4F
market, strategy, growth, finance, investment
Creative
#F6F3F2
#B8432F
design, art, aesthetics, inspiration, creation
Default
#FAFAF8
#4A4A4A
When no clear match — prefer default over wrong match

When a style template is explicitly chosen, its colors take precedence over tone sensing. Use tone sensing as the default when no style is specified.

Rule 5: Title Protection

If the user provides a title explicitly, use it as-is for the main headline. Put editorial interpretation into subtitle, summary, or side modules. Do not silently rewrite the user's title.

Rule 6: Typography Hierarchy

Maintain a clear type scale and use it consistently:

  • Hero title:
    32px–48px
    , weight 700–900, tight letter-spacing (
    -0.02em
    )
  • Subtitle / summary:
    16px–20px
    , weight 400–500
  • Body text:
    14px–16px
    , weight 400, line-height
    1.6–1.7
  • Meta / tags / captions:
    11px–13px
    , weight 500–700, uppercase with letter-spacing
  • Body text color: never pure black — use
    #1a1a1a
    ,
    #333
    , or
    #4a4a4a

Rule 7: Visual Weight Distribution

At least one module should feel visually heavier than the others. Avoid making every panel use the exact same treatment. Differentiate through scale, background tone, typographic weight, or accent rules.

Rule 8: Taste Rules (Anti-AI Checklist)

Before finalizing any card, check against these common AI-generated visual patterns:

Layout:

  • No centered hero — Do not default-center titles. Prefer left-aligned or asymmetric
  • No equal-width tiles — Three equal columns side by side is the #1 AI signature. Use
    2fr 1fr
    , asymmetric grids, or staggered layouts
  • No uniform panels — At least one panel must differ in scale, weight, or treatment

Typography:

  • No pure black
    #000000
    — Use off-black (
    #1a1a1a
    ,
    #2d2a26
    ) or warm/cool dark
  • No oversized-only hierarchy — Build hierarchy with weight and color, not just font-size scaling

Color:

  • Max 1 accent color, saturation < 80%
  • No neon gradients — No purple-blue AI glow, no gradient-filled headlines
  • Consistent temperature — Do not mix warm gray and cool gray in one card

Content:

  • No filler data — Avoid
    99.99%
    ,
    50%
    ,
    1234567
    . Use organic numbers (
    47.2%
    ,
    3.8M
    )
  • No AI phrasing — Avoid "empower", "seamless", "unleash", "next-generation"

Spacing:

  • Padding and margins must be mathematically precise, no awkward gaps
  • Adjacent elements must be visually aligned

Style Examples

Choose a visual family first, then pick the specific template inside that family. This keeps the library broad without forcing a flat 29-style scan every time.

Style Families

Warm Editorial and Storytelling

Use when the card should feel reflective, human, narrative, or culturally textured.

StyleFileSuitable For
Editorial Warmstyles/editorial-warm.mdKnowledge summaries, book notes, essays, analytical reports
Customer Spotlightstyles/customer-spotlight.mdCustomer stories, case studies, success recaps, brand narratives, adoption stories
Sunset Warmstyles/sunset-warm.mdCommunity recaps, event notes, lifestyle summaries, positive storytelling
Midcenturystyles/midcentury.mdBrand stories, retro-modern campaigns, culture notes, design narratives

Soft Lifestyle and Teaching

Use when the card should feel calm, approachable, and low-pressure.

StyleFileSuitable For
Soft Neutralstyles/soft-neutral.mdLifestyle content, wellness, education, gentle branding, creative workshops
Slate Chalkstyles/slate-chalk.mdTeaching content, lessons, concept explanations, workshop notes
Education Studiostyles/education-studio.mdTeaching notes, course modules, learning summaries, workshop guides

Paper, Research, and Governance

Use when the card should read like a memo, report, brief, or evidence summary.

StyleFileSuitable For
Paper Minimalstyles/paper-minimal.mdProduct notes, task summaries, meeting notes, clean documentation
Lab Journalstyles/lab-journal.mdResearch summaries, scientific explanations, medical content, academic papers
Academic Paperstyles/academic-paper.mdResearch abstracts, paper summaries, literature reviews, evidence-heavy explanations
Policy Paperstyles/policy-paper.mdGovernance notes, policy explainers, legal-adjacent summaries, internal rules
Navy Formalstyles/navy-formal.mdInvestor decks, executive briefs, quarterly reports, corporate proposals
Japanese Minimalstyles/japanese-minimal.mdBrand narratives, cultural notes, quiet product essays, reflective announcements
Clinical Briefstyles/clinical-brief.mdHealthcare summaries, medical notes, patient education, clinical snapshots

Business, Finance, and Trust

Use when the card should look operational, executive, or commercially credible.

StyleFileSuitable For
Corporate Cleanstyles/corporate-clean.mdProduct launches, B2B briefs, executive summaries, formal reports, investor-facing materials
Pitch Deck VCstyles/pitch-deck-vc.mdFundraising cards, market opportunity snapshots, startup traction summaries
Sales Roomstyles/sales-room.mdPipeline reviews, account snapshots, deal strategy notes, revenue briefings
Trust Centerstyles/trust-center.mdSecurity notes, compliance summaries, audit updates, trust-facing reports
Partner Channelstyles/partner-channel.mdPartner briefs, alliance updates, channel motions, co-sell summaries

Technical and Operational

Use when precision, systems language, or implementation detail needs to dominate.

StyleFileSuitable For
Tech Blueprintstyles/tech-blueprint.mdTechnical specs, system design docs, architecture summaries, engineering plans
Engineering Whiteprintstyles/engineering-whiteprint.mdArchitecture notes, API briefs, implementation plans, technical whitepapers
Terminal Greenstyles/terminal-green.mdInfra status cards, CLI guides, incident notes, retro-computing topics

Broadcast, Statement, and High-Contrast

Use when the card should announce, signal urgency, or land a strong visual punch.

StyleFileSuitable For
Bold Contraststyles/bold-contrast.mdData highlights, KPI dashboards, event announcements
News Broadcaststyles/news-broadcast.mdFlash updates, report callouts, media briefings, public announcements
Incident Deskstyles/incident-desk.mdIncident reviews, outage notes, postmortems, reliability updates
Neo Brutalismstyles/neo-brutalism.mdBold campaign cards, manifesto-style summaries, startup launches, punchy statements
Swiss Gridstyles/swiss-grid.mdStructured editorial layouts, design-forward reports, typographic statements

Signature Visual Identities

Use when the visual identity itself is part of the message.

StyleFileSuitable For
Deep Nightstyles/deep-night.mdEntertainment, creative showcases, product reveals, gaming content
Glassmorphismstyles/glassmorphism.mdPremium product reveals, feature spotlights, event invites, future-facing showcases

Layout Skeletons

Choose the content structure family first, then select the specific wireframe. Layouts remain style-agnostic.

Layout Families

Core Single-Topic Cards

Use when one thesis should dominate and supporting content should stay secondary.

LayoutFileBest For
Hero Cardlayouts/hero-card.mdSingle topic with title + summary + one supporting panel
Quote Cardlayouts/quote-card.mdPull-quotes, mission statements, keynote quotes with attribution
Split Panellayouts/split-panel.mdTwo-column layouts: main content + sidebar or left-right comparison
Stacked Moduleslayouts/stacked-modules.mdMulti-section vertical flow with mixed-weight blocks

Metrics and Operational Readouts

Use when numbers, status, or operating signals need to be scanned quickly.

LayoutFileBest For
Metric Boardlayouts/metric-board.mdKPI cards, performance dashboards, quarterly reviews, health checks, metric-driven announcements
Financial Snapshotlayouts/financial-snapshot.mdRevenue summaries, cash views, performance snapshots, unit economics
Sales Brieflayouts/sales-brief.mdPipeline reviews, deal strategy, regional sales updates, revenue operations
Terminal Windowlayouts/terminal-window.mdStatus snapshots, command walkthroughs, incident updates, operational summaries

Sequence, Roadmap, and Progression

Use when the reader needs stages, steps, or directional movement.

LayoutFileBest For
Timeline Flowlayouts/timeline-flow.mdSequential steps, milestones, process stages with vertical timeline
Roadmap Boardlayouts/roadmap-board.mdNOW / NEXT / LATER planning, strategic sequencing, phased rollouts
Funnel Stacklayouts/funnel-stack.mdSales funnels, conversion flows, recruitment pipelines, decision narrowing
Incident Reviewlayouts/incident-review.mdPostmortems, outage reviews, reliability incidents, remediation snapshots

Comparison and Decision

Use when the card needs explicit trade-offs, prioritization, or side-by-side framing.

LayoutFileBest For
Pros & Conslayouts/pros-cons.mdTrade-off analysis, decision framing, risk vs upside, balanced evaluation
Quadrant Matrixlayouts/quadrant-matrix.mdPriority mapping, risk-return framing, portfolio views, 2x2 classification
Comparisonlayouts/comparison.mdSide-by-side contrast, option framing, before/after or A/B comparisons

Grid and Inventory

Use when the card needs repeated modules, mixed-size tiles, or scan-friendly inventories.

LayoutFileBest For
Bento Gridlayouts/bento-grid.mdMulti-topic overviews, feature showcases, mixed-size grid cells
Badge Gridlayouts/badge-grid.mdFeature lists, capability catalogs, skill inventories, benefit showcases
Checklist Boardlayouts/checklist-board.mdExecution tracking, launch readiness, QA gates, operational checklists

System and Relationship Mapping

Use when structure, adjacency, or network relationships matter more than sequence.

LayoutFileBest For
Architecture Maplayouts/architecture-map.mdLayered systems, platform overviews, service boundaries, technical blueprints
Radial Hublayouts/radial-hub.mdEcosystem overviews, core-plus-features, hub-and-spoke relationships

Document and Memo Logic

Use when the card should read like a structured brief with explicit sections.

LayoutFileBest For
Research Abstractlayouts/research-abstract.mdAbstract-summary cards, study findings, evidence synthesis, paper snapshots
Board Memolayouts/board-memo.mdExecutive updates, decision memos, quarterly board notes, leadership summaries
Policy Memolayouts/policy-memo.mdInternal policy changes, governance decisions, process rules, guidance notes
Education Modulelayouts/education-module.mdLesson summaries, learning paths, workshop modules, teaching cards
Healthcare Summarylayouts/healthcare-summary.mdClinical overviews, patient summaries, care snapshots, health education

Governance, Risk, and Audit

Use when ownership, control status, and mitigation detail must be explicit.

LayoutFileBest For
Risk Registerlayouts/risk-register.mdRisk tracking, mitigation planning, compliance reviews, program governance
Compliance Auditlayouts/compliance-audit.mdAudit summaries, control reviews, security posture checks, compliance tracking

Narrative and Stakeholder Updates

Use when the content is about people, teams, customers, or partner motion.

Primitive note:

org-update
,
customer-story
, and
partner-brief
now share a lightweight
card-brief-*
outer rhythm. Keep
news-bulletin
separate unless the structure is actually about relationship or stakeholder motion rather than headline cadence.

LayoutFileBest For
News Bulletinlayouts/news-bulletin.mdBreaking updates, digest cards, status bulletins, press-style recaps
Org Updatelayouts/org-update.mdTeam changes, hiring updates, ownership shifts, leadership communications
Customer Storylayouts/customer-story.mdCase studies, before/after outcomes, customer wins, adoption narratives
Partner Brieflayouts/partner-brief.mdAlliance updates, co-sell notes, partner summaries, channel reviews

Family Alignment Notes

  • Prefer existing family primitives before inventing new class names. Current aligned layout families include
    card-doc-*
    ,
    card-kpi-*
    ,
    card-sequence-*
    ,
    card-tile-*
    ,
    card-map-*
    ,
    card-compare-*
    ,
    card-review-*
    ,
    card-topic-*
    , and
    card-brief-*
    .
  • When a new layout clearly belongs to one of those families, vary geometry and modifiers first. Do not create a parallel primitive vocabulary for the same role.
  • Explicit special cases remain intentionally separate:
    quote-card
    ,
    terminal-window
    ,
    news-bulletin
    , and the strongest identity-driven style themes such as
    deep-night
    and
    glassmorphism
    .
  • If a layout or style only shares mood and not structure, document the family relationship in prose rather than forcing additional primitive convergence.

Design Principles

Space and Breathing Room

  • Card padding:
    32px–48px
    from edges
  • Module gaps:
    16px–24px
  • Title area must have generous line-height (
    1.1–1.3
    ) and clear separation from body
  • Never crowd content against card edges

Visual Accents

  • Use
    4px–6px
    thick rules as section dividers or accent borders
  • Use subtle tinted backgrounds (
    rgba(0,0,0,0.03)
    or style-specific tints) for secondary panels
  • Accent colors should be restrained: one highlight color used for rules, tags, or key numbers
  • Optional:
    4%
    noise overlay for paper texture (see style templates)

Content Rhythm

  • High-density cards: group into overview → core judgment → supporting modules → conclusion
  • Ranking content: asymmetric hero + structured list (avoid equal tiles)
  • Tutorial/analysis content: overview → core insight → detail blocks → boundary/caveats → summary

Styling Reference

Common Classes (shared across all styles)

  • .card-frame
    — outer container with max-width and padding
  • .card
    — main card surface with background, padding, and optional noise overlay
  • .card-meta
    — meta line (category, date, version) in small uppercase
  • .card-title
    — main headline
  • .card-subtitle
    — secondary headline or summary
  • .card-bar
    — thick accent rule divider
  • .card-body
    — body text paragraph
  • .card-body.dropcap
    — first paragraph with drop cap initial letter (editorial opening)
  • .card-highlight
    — standalone short sentence (< 25 chars) with left accent border for key insights
  • .card-grid
    — grid container;
    .card-grid-2
    for two columns
  • .card-panel
    — content panel with border-top accent
  • .card-panel.heavy
    — heavier panel with more padding
  • .card-panel.light
    — lighter panel with thinner border
  • .card-panel-title
    — panel heading in small uppercase
  • .card-panel-text
    — panel body text
  • .card-item
    — titled content block (label + description pair)
  • .card-item-label
    — item title/label
  • .card-tag
    — inline tag/badge
  • .card-stat
    — oversized number/metric display
  • .card-stat-label
    — label beneath a stat
  • .card-divider
    — thin horizontal rule between sections
  • .card-footer
    — bottom strip for source, attribution, or notes
  • .card-endmark
    — end-of-content mark (∎) for editorial closure

Rich Text Elements

Drop cap (first paragraph only — creates editorial opening ceremony):

<p class="card-body dropcap">First paragraph text...</p>

Highlight quote (standalone insight, < 25 chars, with accent left border):

<p class="card-highlight">Key insight phrase</p>

Titled item (label + description pairs, for structured lists):

<div class="card-item">
  <p class="card-item-label">Item Title</p>
  <p class="card-panel-text">Item description text.</p>
</div>

Section divider:

<div class="card-divider"></div>

End mark (editorial closure, placed at content end):

<span class="card-endmark">∎</span>

Best Practices

Content Guidelines

  1. Direct embedding only — Always embed HTML directly in Markdown, never use
    ```html
    code blocks
  2. No empty lines in structure — Keep the entire HTML block continuous
  3. Judge density first — Decide low/medium/high before picking layout
  4. Protect user titles — Never silently rewrite a user-provided headline
  5. Balance visual weight — At least one heavy block, one medium, one light
  6. Use type scale consistently — Follow the size hierarchy defined above
  7. Accent with restraint — One accent color, used sparingly for rules and highlights
  8. Fill space intentionally — If a section looks empty, restructure hierarchy before adding filler content