# font-loading-wasp-drone

font-loading-wasp-drone audits font loading pipelines, eliminates CLS shifts from font swaps, and configures Next.js font delivery.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 96 repo stars
- Author: Legion Code Inc.
- License: AGPL-3.0-or-later · policy=link-only · description only; the file stays with the author
- Source: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/web-development-tools/agents/font-loading-wasp-drone.md
- Updated: 2026-10-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/font-loading-wasp-drone

## What it does

This subagent handles in-browser font loading mechanics. It audits `@font-face` definitions, selects matching `font-display` values, and configures metric-adjusted fallbacks using properties like `size-adjust` and `ascent-override`. That prevents layout shifts during late swaps.

When configuring preload links, the agent verifies `crossorigin="anonymous"` to avoid duplicate font downloads. It also restricts preload tags to 2-3 key assets so image discovery remains unblocked. For Next.js codebases, it targets `app/fonts.ts` while enforcing strict separation between App Router and Pages Router conventions.

The subagent halts immediately instead of guessing if you use a commercial font without an explicit subsetting license.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add legioncodeinc/vibe-coding-tools
```
In the agent chat (not a shell):
```text
/plugin install web-development-tools@wasp-nest
```

2. **Manually: put the files in place**
- File: `.claude/agents/font-loading-wasp-drone.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/font-loading-wasp-drone.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/font-loading-wasp-drone.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/web-development-tools/agents/font-loading-wasp-drone.md

## When to use it
- remove layout shifts caused by font swapping
- configure `next/font` for Next.js App Router setups
- subset variable fonts using CLI tools like pyftsubset
- fix missing crossorigin attributes on font preload tags

## Example prompts
- Audit font loading in this repository and fix CLS from font swap
- Generate a `next/font` configuration for App Router in `app/fonts.ts`
- Give me the subsetting command for our self-hosted variable font

## Similar
- [loading-states](https://affpapa.org/en/nevibecode/skills/dylantarre-loading-states.md) — skill · 640 installs
- [loading-states-and-perceived-performance](https://affpapa.org/en/nevibecode/skills/loading-states-and-perceived-performance.md) — skill · 1000 installs
- [core-web-vitals](https://affpapa.org/en/nevibecode/skills/web-quality-skills-core-web-vitals.md) — skill · 36500 installs
- [font-pairing-suggester](https://affpapa.org/en/nevibecode/skills/font-pairing-suggester.md) — skill · 609 installs
- [animate](https://affpapa.org/en/nevibecode/skills/delphi-ai-animate.md) — skill · 4000 installs
- [frontend-enhancer](https://affpapa.org/en/nevibecode/skills/frontend-enhancer.md) — skill · 978 installs

From the same set: [legioncodeinc/vibe-coding-tools](https://affpapa.org/en/nevibecode/by/legioncodeinc/vibe-coding-tools.md) — 172 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
