Agent skill

Optimization Suggest

by hoangsonww in hoangsonww/Claude-Code-Agent-Monitor

Suggest concrete optimizations for Claude Code usage based on historical session data.

MITAuto-check passed

Install Optimization Suggest

skills CLI
$ npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill optimization-suggest -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hoangsonww/Claude-Code-Agent-Monitor optimization-suggest --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/hoangsonww/Claude-Code-Agent-Monitor.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/ccam-insights/skills/optimization-suggest .claude/skills/optimization-suggest && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
optimization-suggest
GitHub stars
1.1k
Used in
1 other repo
Token cost
~831 tokens
SKILL.md length
323 words
Files
2
Skills in repo
78
Repo updated
First seen
Licence
MIT

At a glance

Suggest concrete optimizations for Claude Code usage based on historical session data.

  • Works in 3 steps: Gather optimization data from… → Analyze optimization opportunities → Quantify each recommendation
  • Data-driven optimization planning
  • SKILL.md covers Input, Procedure and Output Format
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Optimization Suggest is an agent skill from hoangsonww/Claude-Code-Agent-Monitor. Suggest concrete optimizations for Claude Code usage based on historical session data. Covers cost reduction, speed improvement, error prevention, and workflow efficiency. Use for data-driven optimization planning.

Its SKILL.md is about 830 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

The repository describes itself as: 🚀 A real-time monitoring dashboard for Claude Code & Codex, built with SQLite3, Node.js, Express, React, Vite, TailwindCSS, & WebSockets. It tracks sessions, agent activity… The licence is MIT.

When your agent uses it

  • Data-driven optimization planning

Example prompts

  • “/optimization-suggest”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Gather optimization data from http://localhost:4820
  2. Analyze optimization opportunities
  3. Quantify each recommendation

What it can do on your machine

Read from SKILL.md and the folder at commit e0f4a1a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Optimization Suggest loads about 831 tokens when it runs. Until then it costs about 59 tokens; SKILL.md has 323 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~59
When it runs · the whole SKILL.md, loaded when a task matches
~831

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from hoangsonww/Claude-Code-Agent-Monitor at commit e0f4a1a, republished under its MIT licence (© hoangsonww). 323 words, ~831 tokens.

Download SKILL.mdSave it as .claude/skills/optimization-suggest/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
optimization-suggest
description
Suggest concrete optimizations for Claude Code usage based on historical session data. Covers cost reduction, speed improvement, error prevention, and workflow efficiency. Use for data-driven optimization planning.

Optimization Suggest

Generate data-driven optimization recommendations for Claude Code usage.

Input

The user provides: $ARGUMENTS

This may be:

  • "all" or empty (default: comprehensive optimization scan)
  • "cost" for cost reduction focus
  • "speed" for performance/speed focus
  • "quality" for error reduction focus
  • "efficiency" for workflow efficiency focus

Procedure

  1. Gather optimization data from http://localhost:4820:

    • GET /api/sessions?limit=200 — session history
    • GET /api/analytics — tool and token analytics
    • GET /api/pricing/cost — cost data
    • GET /api/pricing — pricing rules for model comparison
    • Sample event streams for behavioral analysis
  2. Analyze optimization opportunities:

    💰 Cost Optimization
    • Model downgrade opportunities: Tasks completed with expensive models that could use cheaper ones
      • Compare success rates per model per task type
      • Calculate savings from model substitution
    • Cache optimization: Sessions with low cache hit rates
      • Identify sessions that could benefit from better prompt caching
    • Early termination: Sessions that ran longer than needed
      • Detect sessions where useful work completed well before session end
    • Compaction reduction: Sessions hitting context limits
      • Suggest breaking large tasks into smaller sessions
    ⚡ Speed Optimization
    • Tool selection: Faster alternatives for commonly-used tool patterns
    • Subagent parallelization: Tasks that could run in parallel
    • Session planning: Better upfront context to reduce back-and-forth
    • Preemptive context loading: Frequently needed files/context
    🛡 Quality Optimization
    • Error prevention: Common error patterns with preventive measures
    • Tool reliability: Tools with high failure rates and alternatives
    • Validation gaps: Sessions lacking verification steps
    • Recovery strategies: Better error handling patterns
    🔄 Workflow Optimization
    • Session sizing: Optimal session scope based on historical success
    • Task decomposition: Complex sessions that should be split
    • Automation candidates: Repetitive workflows to automate
    • Knowledge reuse: Patterns where previous session context could help
  3. Quantify each recommendation:

    • Estimated impact (cost savings $, time savings %, error reduction %)
    • Implementation effort (low/medium/high)
    • Confidence level based on data available
    • Priority score = Impact × Confidence / Effort

Output Format

Present as a prioritized optimization plan:

#RecommendationCategoryImpactEffortPriority
1Specific action💰/⚡/🛡/🔄HighLow★★★★★
2Specific action.........★★★★☆

For the top 5 recommendations, include:

  • Detailed explanation with supporting data
  • Step-by-step implementation guide
  • Expected before/after metrics
  • How to measure success

© hoangsonww, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in plugins/ccam-insights/skills/optimization-suggest of hoangsonww/Claude-Code-Agent-Monitor.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit e0f4a1a

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in hoangsonww/Claude-Code-Agent-Monitor, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Optimization Suggest next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Optimization Suggest compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Optimization Suggest this skillhoangsonww/Claude-Code-Agent-Monitor1.1k1 repos~831Automated safety check: PassMIT
SQL Optimizationgithub/awesome-copilot40k2 repos~2.3kAutomated safety check: PassMIT
Agent Performance Optimizerruvnet/ruflo74k2 repos~3.6kAutomated safety check: PassMIT
Database Optimizerdavila7/claude-code-templates32k8 repos~2.5kAutomated safety check: PassMIT
Prompt Optimizeraffaan-m/ECC275k2 repos~2.4kAutomated safety check: PassMIT
Cost Optimizeruvnet/ruflo74k1 repos~997Automated safety check: NotesMIT

Similar skills

  • SQL Optimization

    github/awesome-copilot

    Official

    Universal SQL performance optimization assistant for comprehensive query tuning, indexing strategies, and database performance analysis across all SQL databases (MySQL, PostgreSQL, SQL Server…

    40k GitHub starsUsed in 2 repos~2.3k tokens
    DatabasesAuto-check passed
  • Agent skill for performance-optimizer - invoke with $agent-performance-optimizer

    74k GitHub starsUsed in 2 repos~3.6k tokens
    Auto-check passed
  • Database Optimizer

    davila7/claude-code-templates

    Expert database optimizer specializing in modern performance tuning, query optimization, and scalable architectures.

    32k GitHub starsUsed in 8 repos~2.5k tokens
    DatabasesAuto-check passed
  • Prompt Optimizer

    affaan-m/ECC

    分析原始提示,识别意图和差距,匹配ECC组件(技能/命令/代理/钩子),并输出一个可直接粘贴的优化提示。仅提供咨询角色——绝不自行执行任务。触发时机:当用户说“优化提示”、“改进我的提示”、“如何编写提示”、“帮我优化这个指令”或明确要求提高提示质量时。中文等效表达同样触发:“优化prompt”、“改进prompt”、“怎么写prompt”、“帮我优化这个指令”。不触发时机:当用户希望直接执行任…

    275k GitHub starsUsed in 2 repos~2.4k tokens
    DevelopmentAuto-check passed
  • Cost Optimize

    ruvnet/ruflo

    Analyze token usage patterns and recommend cost optimizations with estimated savings

    74k GitHub starsUsed in 1 repo~997 tokens
    AI & LLM EngineeringAuto-check: notes
  • Suggestion Box

    paperclipai/paperclip

    Quietly suggest a concrete improvement after observing material, generalizable friction in agent work.

    99k GitHub stars~1.3k tokensUpdated today
    Auto-check passed

More from hoangsonww/Claude-Code-Agent-Monitor

All 78 skills in this repo
  • Budget Set

    hoangsonww/Claude-Code-Agent-Monitor

    Define a spend budget for Claude Code and, optionally, create a cost alert rule that fires when usage crosses the limit, via POST /api/alerts/rules on the Agent Monitor dashboard.

    1.1k GitHub starsUsed in 1 repo~1k tokens
    Auto-check passed
  • Version Release

    hoangsonww/Claude-Code-Agent-Monitor

    Choose and apply the correct semantic version bump for this repository.

    1.1k GitHub stars~1.6k tokensUpdated 2 days ago
    Auto-check passed
  • Cost Breakdown

    hoangsonww/Claude-Code-Agent-Monitor

    Break down Claude Code costs using the Agent Monitor pricing engine.

    1.1k GitHub starsUsed in 1 repo~845 tokens
    Auto-check passed
  • File Headers

    hoangsonww/Claude-Code-Agent-Monitor

    MANDATORY for every coding agent (Claude Code, Codex, or any other) on every change-set — every applicable source file the agent creates or updates MUST start with the project's copyright/authorship…

    1.1k GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • Hook Diagnostics

    hoangsonww/Claude-Code-Agent-Monitor

    Diagnose Claude Code hook installation, delivery, and ingestion issues.

    1.1k GitHub starsUsed in 1 repo~676 tokens
    Auto-check passed
  • Memory Review

    hoangsonww/Claude-Code-Agent-Monitor

    Review the file-based memory store via the Agent Monitor Config Explorer API: the user and project CLAUDE.md plus per-project auto-memory files under ~/.claude/projects/<slug/memory/.md.

    1.1k GitHub starsUsed in 1 repo~970 tokens
    Auto-check passed

Questions about Optimization Suggest

What does Optimization Suggest do?

Suggest concrete optimizations for Claude Code usage based on historical session data. Optimization Suggest is an agent skill from hoangsonww/Claude-Code-Agent-Monitor. Suggest concrete optimizations for Claude Code usage based on historical session data.

When should I use Optimization Suggest?

Optimization Suggest fits situations like: data-driven optimization planning.

How do I install Optimization Suggest in Claude Code?

Run `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill optimization-suggest -a claude-code`. Or copy the skill folder (plugins/ccam-insights/skills/optimization-suggest in hoangsonww/Claude-Code-Agent-Monitor) into .claude/skills/optimization-suggest in your project. Claude Code loads it when a task matches its description.

How do I install Optimization Suggest in Codex?

Run `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill optimization-suggest -a codex`. Or copy the skill folder (plugins/ccam-insights/skills/optimization-suggest in hoangsonww/Claude-Code-Agent-Monitor) into .agents/skills/optimization-suggest in your project. Codex loads it when a task matches its description.

Can I use Optimization Suggest in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill optimization-suggest -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/optimization-suggest, .gemini/skills/optimization-suggest, .github/skills/optimization-suggest and .opencode/skills/optimization-suggest in your project.

What does Optimization Suggest need to run?

SKILL.md names no scripts, command-line tools or credentials: Optimization Suggest is instructions for the agent only.

Does Optimization Suggest access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Optimization Suggest safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Optimization Suggest use?

Optimization Suggest is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Optimization Suggest use?

About 831 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Optimization Suggest?

Skills that share tags, products or a category with Optimization Suggest: SQL Optimization (github/awesome-copilot, 40k stars), Agent Performance Optimizer (ruvnet/ruflo, 74k stars), Database Optimizer (davila7/claude-code-templates, 32k stars) and Prompt Optimizer (affaan-m/ECC, 275k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Optimization Suggest?

hoangsonww (a GitHub user) maintains it in hoangsonww/Claude-Code-Agent-Monitor, which has 1,052 GitHub stars. The repository holds 78 skills in this directory. The repository was last updated on October 6, 2026.

Source: hoangsonww/Claude-Code-Agent-Monitor on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.