module-federation-debugging

module-federation-debugging is a skill for Claude Code, Codex from soulcodex/agentic. It costs 44 tokens per session (1,190 once invoked), scanned A, original, MIT.

A troubleshooting skill for applications that use Module Federation, a way to load separately built frontend parts at runtime. It traces failures across configuration, network requests, runtime loading, shared packages, generated types, browsers, and servers.

In plain words
What is it for?
Use it to investigate manifests, remote entries, loading errors, CORS and DNS issues, shared dependencies, generated types, browser loading, server loading, and hydration boundaries.
Why use it?
It helps narrow a blank page, timeout, missing module, type error, or production-only failure to the part that is actually broken.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: mentions Codex; mentions OpenCode.

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/soulcodex/agentic/module-federation-debugging
Any agent
npx skills add soulcodex/agentic --skill module-federation-debugging
Clone the repo
git clone --depth 1 https://github.com/soulcodex/agentic

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for module-federation-debugging

README.md
[![agentmods](https://agentmods.dev/badge/skills/soulcodex/agentic/module-federation-debugging.svg)](https://agentmods.dev/skills/soulcodex/agentic/module-federation-debugging)
Your own site
<a href="https://agentmods.dev/skills/soulcodex/agentic/module-federation-debugging"><img src="https://agentmods.dev/badge/skills/soulcodex/agentic/module-federation-debugging.svg" alt="Measured on agentmods" height="20"></a>
Per session 44 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,190 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00044 $0.01190
Opus 5 $0.00022 $0.00595
Sonnet 5 $0.00009 $0.00238
Haiku 4.5 $0.00004 $0.00119

Measured 2d ago against content hash 3341dab27f66, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

module-federation-debugging scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/ui/module-federation-debugging/SKILL.md · 126 lines

How it starts

The opening of the file, as written. The whole thing — 126 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Module Federation Debugging Skill

Use this skill when a Module Federation host or remote fails to load, renders a blank page, hangs in a loading state, throws a RUNTIME-xxx error, has unclear shared dependency behavior, cannot resolve generated types, fails only in production, or behaves differently between browser and SSR.

For SSR-specific architecture choices and host/remote creation, also use the module-federation-ssr skill when it is available. This skill owns the debugging investigation; the SSR skill owns SSR architecture boundaries.

Step 1 - Name The Failure Boundary

Do not start by changing configuration. First classify the likely boundary:

Boundary Common Signals
config missing plugin, wrong plugin, bad expose key, missing async startup
producer artifact stale or missing manifest, remote entry, exposes, stats, types
network 404, 5xx, CORS, DNS, timeout, CDN, gateway, mixed content
runtime RUNTIME-xxx, container missing, script execution failure
shared dependency duplicate React/Vue, wrong singleton, externals conflict
type contract missing @mf-types, producer DTS failure, path mapping issue
render remote loaded but component throws or error boundary trips
SSR/hydration server loads differently than browser, hydration mismatch
cache/version host and remote use different deployed artifact versions

If the boundary is unclear, read resources/evidence-map.md and collect the minimum facts needed to narrow it.

Step 2 - Collect Evidence In Order

Use this order unless a hard error points to a narrower path:

  1. Effective host and remote Module Federation config.
  2. Runtime role: host, remote, or both.
  3. Rendering mode: CSR, client-only island in SSR app, or true SSR federation.
  4. Remote declaration, manifest URL, remote entry URL, and requested expose key.
  5. Browser Network and console evidence.
  6. Server logs and Node/SSR observability files when SSR is involved.
  7. Shared dependency versions and singleton policy.
  8. Generated type artifacts and TypeScript diagnostics.
  9. Build stats, manifest/snapshot data, and deployment version.

Read the full file on GitHub · 126 lines

Files

What ships with it

3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 126 lines · 44 tokens per session scan A 3341dab27f66

Subscribe to this mod's changes

module-federation-debugging is a skill published in the GitHub repository soulcodex/agentic (10 stars, last pushed yesterday), licensed MIT. It adds 44 tokens to every session and 1,190 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

logging-observability-standards

When setting up telemetry, debugging distributed systems, or standardizing application output.

KraitDev/skiLL.Md · 23 tokens

agent-inspect

Local evidence debugger and trajectory-test toolkit for TypeScript AI agents. Use when capturing framework-faithful traces, asserting TraceContract/TraceFacts, packaging Evidence v2, or inspecting local runs over read-only MCP (gettracefacts).

rajudandigam/agent-inspect · 52 tokens

agent-upkeep

Perform one small, scoped maintenance improvement to the Elements monorepo and open a single reviewable pull request. Use this skill for scheduled or unattended upkeep runs that improve unit test coverage for one file, fix one behavioral bug in one module, or move one off ESLint rule toward enforcement to reduce…

NVIDIA/elements · 115 tokens

guidance-webgpu-performance

Diagnose and improve browser WebGPU rendering performance, including frame pacing, draw and state-submission overhead, buffer uploads, shaders, and JavaScript work on the render critical path. Use for slow or stuttering GPU-backed interfaces, rendering regressions, CPU/GPU bottleneck analysis, or renderer performance…

NVIDIA/elements · 83 tokens

authoring-tests

Write and run automated tests for Elements components including unit, accessibility, visual, SSR, and lighthouse tests. Use this skill whenever the user wants to write, create, update, or debug test files (.test.ts, .test.axe.ts, .test.visual.ts, .test.ssr.ts, .test.lighthouse.ts). Also trigger when the user asks…

NVIDIA/elements · 113 tokens

troubleshooting

Diagnose and resolve common issues including test failures, build errors, performance regressions, and development environment problems. Use this skill whenever the user reports something broken, failing, timing out, hanging, or producing unexpected results. Trigger on test failures (elementIsStable timeouts, flaky…

NVIDIA/elements · 106 tokens