token-efficiency

Estimate token consumption and rate-limit risk for ARAYA workflows.

3|Updated May 28, 2026
One-click install
npx skills add https://github.com/mahg-es/araya --skill token-efficiency-mahg-es
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: token-efficiency
Source: https://github.com/mahg-es/araya/tree/main/skills/token-efficiency
Command: npx skills add https://github.com/mahg-es/araya --skill token-efficiency-mahg-es

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ARAYA optimization layer that maximizes productive work within provider quotas. Works transparently for ARAYA workflows, direct pi conversations, agent delegations, and sub-agent executions.

Core Features & Use Cases

  • Estimate token consumption before execution: input + output + reasoning
  • Check rate-limit risk based on recent usage patterns
  • If risk detected, recommend: decomposition, compression, or deferral
  • Apply provider-specific optimization profile
  • Generate context capsules for reusable information
  • Track consumption across session
  • Report efficiency metrics

Quick Start

Provide a token-budget aware optimization plan for the next ARAYA task by decomposing prompts and reusing context.

Frequently Asked Questions about token-efficiency

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

FAQPage Schema
How do I estimate token consumption before executing prompts in multi-agent workflows?

Token consumption is estimated before execution by calculating input, output, and reasoning tokens. This pre-execution estimation helps predict usage and avoid exceeding provider rate limits or token quotas during complex multi-agent orchestration.

What should I do when my context window risks hitting provider rate limits?

When rate-limit risk is detected based on recent usage patterns, the recommended actions are task decomposition, prompt compression, or deferral. These strategies reduce immediate token load and help maintain productive work within provider quotas.

How does context capsule generation work for reusable information in ARAYA sessions?

Context capsules are generated to package and reuse information across ARAYA sessions. This mechanism preserves critical context efficiently, reducing redundant token generation when repetitive information is needed across different workflows or agent delegations.

Can I apply provider-specific optimization profiles to manage token efficiency?

Provider-specific optimization profiles can be applied to tailor token usage strategies to individual provider constraints. This ensures that interactions are optimized according to the specific rate limits and quota rules of the target provider.

How do I track token usage and report efficiency metrics across a session?

Token usage is tracked continuously across the session, culminating in reported efficiency metrics. This tracking monitors consumption patterns, providing visibility into how effectively token quotas are being utilized for productive work.