prompt-budget-advisor-skill
v0.1.0
Published
Portable Agent Skill installer for estimating prompt token budget and rewriting prompts to use less context.
Maintainers
Readme
prompt-budget-advisor-skill
Portable Agent Skill for estimating visible prompt token budget and rewriting prompts so they are shorter, clearer, and easier for coding agents or chat agents to execute.
The package installs a standards-style prompt-budget-advisor skill for Codex and Claude Code.
Install
Install to both personal Codex and Claude skill directories:
npx prompt-budget-advisor-skill installInstall to one agent:
npx prompt-budget-advisor-skill install --target codex
npx prompt-budget-advisor-skill install --target claudeInstall into a project:
npx prompt-budget-advisor-skill install --scope project --target bothInstall into the open .agents/skills location:
npx prompt-budget-advisor-skill install --target agentsUsage
Ask your agent to use prompt-budget-advisor, or invoke /prompt-budget-advisor in agents that support slash skill invocation.
Example prompt:
Use prompt-budget-advisor to estimate this prompt's context cost and rewrite it:
<paste prompt here>The skill reports an approximate visible-token estimate, prompt-budget issues, a clearer rewrite, and a shorter variant.
CLI
prompt-budget-advisor-skill help
prompt-budget-advisor-skill validate
prompt-budget-advisor-skill pathDefault user locations:
- Codex:
$CODEX_HOME/skillsor~/.codex/skills - Claude:
$CLAUDE_HOME/skillsor~/.claude/skills - Agents:
$AGENTS_HOME/skillsor~/.agents/skills
Notes
Token counts are estimates. The real context consumed by an agent also includes hidden system/developer messages, prior conversation, tool output, files read into context, and model-specific tokenization overhead.
