14kb-club

📁 handxr/14kb-club 📅 9 days ago

总安装量

周安装量

#51558

全站排名

安装命令

npx skills add https://github.com/handxr/14kb-club --skill 14kb-club

Agent 安装分布

opencode 4

gemini-cli 4

github-copilot 4

codex 4

claude-code 3

amp 3

Skill 文档

14KB Club

Audit web projects against the 14KB TCP slow start budget. Conservative approach: report and suggest, never auto-apply.

Workflow

Identify target directory or file

Run the auditor script:

python3 <skill-path>/scripts/14kb_club.py <file_or_dir> --json

Parse JSON output
Present budget bar (if build detected) + issues grouped by severity
Propose fixes starting with errors, then warnings
Wait for user approval before applying changes
Re-run after fixes to verify improvement

Running the Auditor

# Single file
python3 <skill-path>/scripts/14kb_club.py index.html

# Entire project (auto-detects framework + build folder)
python3 <skill-path>/scripts/14kb_club.py src/

# Scan build output for real gzipped sizes
python3 <skill-path>/scripts/14kb_club.py dist/

# Custom budget (default: 14KB)
python3 <skill-path>/scripts/14kb_club.py . --budget 10

# Force a specific build directory
python3 <skill-path>/scripts/14kb_club.py . --build-dir .next/

# Include low-severity hints
python3 <skill-path>/scripts/14kb_club.py . --strict

# Machine-readable JSON
python3 <skill-path>/scripts/14kb_club.py . --json

What It Detects

CSS Critical Path (severity: error)

External CSS in <head> without media attribute â render-blocking
No inline <style> for critical CSS â all CSS is external
@import chains in CSS files â sequential blocking requests
CSS files > 14KB gzipped

JS Blocking (severity: error)

<script src> without defer/async in <head> â blocks parsing
Known third-party blocking scripts (GA, GTM, Facebook, Intercom, etc.)
Legacy DOM write methods â blocks parsing
JS files > 14KB gzipped

Fonts (severity: warning)

@font-face without font-display: swap â invisible text (FOIT)
Font files not preloaded â late discovery
Google Fonts loading 4+ weights â each adds 20-50KB
More than 2 font families

HTML Bloat (severity: warning)

Inline SVGs > 2KB
data: URIs > 1KB
HTML > 14KB uncompressed
Excess meta/preload tags (10+)
Inline style blocks > 5KB

Build Mode

When a build folder is detected (or specified with --build-dir), the script measures real gzipped sizes and renders a budget bar:

Budget: [===========>   ] 11.2 / 14.0 KB gzipped (80%)

  HTML:   3.2 KB  [====      ] 23%
  CSS:    4.1 KB  [=====     ] 29%
  JS:     3.9 KB  [=====     ] 28%
  Fonts:  0.0 KB  [          ]  0%

Status: PASS â 2.8KB under budget

Auto-detected frameworks: Next.js, Vite, Astro, Nuxt, Angular, SvelteKit, Remix, Gatsby, CRA, Plain HTML, PHP.

Interpreting Results

!! Error: Render-blocking issue â fix immediately
!~ Warning: Significant weight contributor â fix in performance-critical pages
~~ Info: Minor optimization opportunity (only with --strict)

Fix Priority

Render-blocking CSS â inline critical CSS, defer the rest
Render-blocking JS â add defer or async, move before </body>
Third-party scripts â defer/async or load via tag manager
Font loading â add font-display: swap + preload
HTML bloat â extract SVGs, remove data URIs, trim meta tags

Detailed Rules

For complete detection rules, edge cases, and fix patterns, read references/14kb-rules.md.

GitHub 仓库 ↗ ← 返回陌讯 Skills 聚合平台