What went wrong?
The /context command displays the absolute token count for skills (the full SKILL.md content), not the minimal amount of tokens they actually consume at startup (only name and description from the YAML frontmatter).
This confuses users because it appears as though all skill tokens are loaded into context, when in fact skills use progressive disclosure—only their metadata (~100 tokens per skill) is loaded initially, with full content loaded on-demand when triggered.
What should happen?
The /context command should either:
- Display the actual tokens consumed (just name + description metadata), or
- Clearly indicate that the displayed token count is the "potential maximum" vs "currently loaded" amount, or
- Show both values (e.g., "50 / 2,500 tokens" meaning 50 loaded, 2,500 if fully activated)
Steps to reproduce
- Install several skills (user or project level)
- Run
/context command
- Observe that skills show their full token counts
- Compare to actual context usage—skills aren't fully loaded until triggered
Environment
- Version: 2.0.74 (Claude Code)
- OS: macOS 26.2 (Tahoe)
- Terminal: Warp v0.2025.12.17.17.17.stable_02
Is this a regression?
Don't know - this may have always been the behavior, but it's misleading given the progressive disclosure architecture.
What went wrong?
The
/contextcommand displays the absolute token count for skills (the full SKILL.md content), not the minimal amount of tokens they actually consume at startup (onlynameanddescriptionfrom the YAML frontmatter).This confuses users because it appears as though all skill tokens are loaded into context, when in fact skills use progressive disclosure—only their metadata (~100 tokens per skill) is loaded initially, with full content loaded on-demand when triggered.
What should happen?
The
/contextcommand should either:Steps to reproduce
/contextcommandEnvironment
Is this a regression?
Don't know - this may have always been the behavior, but it's misleading given the progressive disclosure architecture.