joycraft-optimize

Audit Claude Code or Codex sessions for token overhead and recommendations.

14|1|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/maksutovic/joycraft --skill joycraft-optimize
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: joycraft-optimize
Source: https://github.com/maksutovic/joycraft/tree/main/.agents/skills/joycraft-optimize
Command: npx skills add https://github.com/maksutovic/joycraft --skill joycraft-optimize

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audits Claude Code or Codex sessions for token overhead and provides actionable recommendations to improve efficiency.

Core Features & Use Cases

  • Detects platform usage (Claude Code vs Codex) and harness statistics
  • Audits harness files, plugins, and MCP servers to surface optimization opportunities
  • Produces a concise diagnostic report to guide future sessions

Quick Start

Run joycraft-optimize in your project to generate a session-overhead diagnostic report.

Frequently Asked Questions about joycraft-optimize

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I reduce token overhead in Claude Code sessions?

To reduce token overhead in Claude Code sessions, audit your local project configuration files such as CLAUDE.md and the .claude directory to identify heavy plugins and MCP servers. This generates a diagnostic report surfacing optimization opportunities.

What's the best way to audit Codex session overhead?

The best way to audit Codex session overhead is to analyze project footprints like AGENTS.md and the .agents directory to enumerate installed plugins and harness files. This produces a concise diagnostic report guiding future efficiency improvements.

How does MCP server impact affect Claude Code token usage?

MCP server impact affects Claude Code token usage by increasing session overhead through loaded configurations. Auditing these servers alongside harness files identifies unnecessary token consumption and provides actionable recommendations to streamline sessions.

Do I need CLAUDE.md to optimize session overhead?

Yes, you need local project configuration footprints like CLAUDE.md, AGENTS.md, and the .claude or .agents directories. Accessing these files is required to enumerate installed plugins, MCP servers, and harness files for the overhead audit.

Can I detect platform usage differences between Claude Code and Codex?

Yes, you can detect platform usage differences between Claude Code and Codex. The audit process identifies the active platform and harness statistics, then evaluates the corresponding configuration files to surface targeted optimization opportunities.

Why does plugin load increase token usage in AI coding sessions?

Plugin load increases token usage in AI coding sessions by inflating the session context with unnecessary configuration data. Auditing these plugins identifies redundant overhead, allowing you to trim active extensions and produce a more efficient diagnostic workflow.