mcpField
H
html-style

html-style

github.com/shipshitdevDesign & UI38232 installsUpdated 2d ago
Repository

About html-style

html-style is a skill for applying a specified design system to barebones HTML. It maps CSS classes to common elements and describes when to add interactive scripts.

Key features

  1. 01Style HTML with a design system
  2. 02Classes for statuses, trends, and tags
  3. 03Table and section styling
  4. 04Guidance for collapsible sections and scripts
  5. 05Rules for dark themes

Use cases

  1. 01Style tables and status text
  2. 02Add interactions to drafts or copy buttons
  3. 03Style output from quick-view or table-filters

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/shipshitdev/skills --skill html-style

After installing, type/html-stylein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

plugin.json
README.md
assets/
base.css
references/
style-guide.md

Details

From the project README

html-style

Transform barebones HTML into styled output using a specific design system.

Workflow

  1. Read the user's HTML
  2. Identify elements to style (tables, lists, status text, buttons, sections)
  3. Inject <style> block from assets/base.css
  4. Add appropriate classes to HTML elements
  5. Add interactive JS if needed (copy buttons, drafts, collapsible sections)

Quick Class Reference

ElementClassEffect
Status text.stale .warm .pendingRed/green/orange inline text
Trend.trend-up .trend-downGreen ↑ / Red ↓
Category tag.tag-group .tag-dm .tag-moneyBlue/purple/orange pill
Status pill.status-success .status-error .status-pendingFilled green/red/orange
Filter toggle.filter .filter.activeOutline / filled black
Time filter.pill .pill.activeSmall pill, black when active
Stat box.stat > .stat-value + .stat-label28px number, 12px label
Tabledefault or .table-styledMinimal or colored values
Section header.section-headerDark bar with white text
Collapsible<details> + <summary>Native HTML collapse
Insight.insightItalic, yellow background
Tier.tier-gold .tier-silver .tier-bronzeRow background colors

Element Styling Rules

Tables
  • Default: minimal borders, no hover
  • Add .table-styled for: hover effect, .positive/.negative cell colors, .highlight rows
  • Sortable: add th.sortable with <a href="?sort=col">Col ▼</a>
Status Indicators
  • Text status (.stale/.warm/.pending): Use for inline status in sentences
  • Status pills (.status-*): Use for badge-style indicators, typically with icon (✓ ✗ ◷)
  • Trends (.trend-up/.trend-down): Use for numeric changes, adds arrow automatically
Sections

Use .section-header with emoji prefix for visual breaks:

<div class="section-header">🔴 URGENT</div>
<div class="section-header">🟠 PENDING</div>
Interactive Elements

When HTML has drafts or copy buttons, add this JS:

function saveDraft(el) {
    localStorage.setItem('draft:' + el.dataset.threadId, el.textContent);
}
function copyToClipboard(text, btn) {
    navigator.clipboard.writeText(text).then(() => {
        btn.textContent = 'Copied!';
        setTimeout(() => btn.textContent = 'Copy', 1500);
    });
}
Deep Links

Convert URLs to native app links:

  • Telegram: tg://resolve?domain=username
  • SMS: sms:+14155551234

Theme

  • Default: Light (background: #fff)
  • Dark mode: Add class="dark" to <body> when user requests dark theme or context is trading/real-time

Compatibility with Structure Skills

When styling output from quick-view or table-filters, these class mappings apply:

quick-view classes
Their ClassStyle As
.type-user.status-pending (blue border)
.type-draft.status-pending (orange border)
.type-done.status-success (green border)
.sourceAlready styled (muted, small)
.metaAlready styled (muted header)
.actionsInline button group
table-filters classes
Their ClassStyle As
.filter-barFlex row with gap
.filter-chipsInline chip container
.chipDark pill with .chip-remove
.filter-menuDropdown panel (.filter-menu)
.empty-stateCentered, muted text

The base.css includes styles for these classes automatically.

Resources

Comments

Markdown supported