Skip to content
Skills Library
AI & agents · Automation

optim-agent

/optim-agent

Guide agent-driven parameter optimization for configurable systems with measurable objectives. Use for HPO, inference tuning, simulations, or RL/control experiments.

Licence
MIT
Last repository change
26.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
3
Deprecation

No signals detected. Repository changed on 26.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Guide agent-driven parameter optimization for configurable systems with measurable objectives. Use for HPO, inference tuning, simulations, or RL/control experiments.

Original author description

Guide agent-driven parameter optimization for configurable systems with measurable objectives. Use for HPO, inference tuning, simulations, or RL/control experiments.

How it works

  1. Overview
  2. When to Use This Skill
  3. Do not use this skill when
  4. Instructions
  5. Examples
  6. Best Practices
  7. Limitations
  8. Additional Resources
Original SKILL.md headings · 64 lines, 504 words
SKILL.md preview
---
name: optim-agent
description: "Guide agent-driven parameter optimization for configurable systems with measurable objectives. Use for HPO, inference tuning, simulations, or RL/control experiments."
category: data
risk: safe
source: community
source_repo: Optim-Agent/optim-agent
source_type: community
date_added: "2026-07-15"
author: Optim-Agent
tags: [optimization, hyperparameter-optimization, experiments, tuning]
tools: [claude, cursor, gemini, codex]
license: MIT
license_source: "https://github.com/Optim-Agent/optim-agent/blob/main/LICENSE"
---

# Optim Agent

## Overview

Use this skill to optimize configurable systems against a measurable scalar objective. It helps an agent turn vague tuning requests into bounded experiments with a defined search space, budget, baseline, and evidence-backed recommendation.

## When to Use This Skill

- Use when tuning hyperparameters, prompts, inference settings, simulation parameters, quantitative strategies, or RL/control policies.
- Use when the objective can be measured as a scalar score, loss, accuracy, cost, latency, reward, or risk-adjusted metric.
- Use when the user needs a small-budget optimization loop with trial history, comparisons, and stop criteria.

## Do not use this skill when

- The objective is purely subjective and cannot be scored consistently.
- The user has not provided permission to run experiments or consume compute/API budget.
- The task is a one-shot implementation, debugging, or code review request with no configurable search space.

## Instructions

1. Define the optimization target in one sentence: maximize or minimize one scalar metric.
2. List the tunable parameters, valid ranges, types, defaults, and any forbidden combinations.
3. Establish at least one baseline before proposing agent-guided trials.
4. Set the budget up front: number of trials, time, compute, money, or dataset subsample.
5. Run or request trials one at a time unless the user explicitly approves parallel execution.
6. Record every trial with parameters, metric value, notes, and failure status.
7. Compare the best result against the baseline and a simple search strategy when possible.
8. Stop when the budget is exhausted, the improvement plateaus, or the next trial cannot be justified from evidence.
9. Report the recommended configuration, measured gain, tradeoffs, and any validation still needed before production use.

## Examples

### Example 1: Hyperparameter optimization

Tune learning rate, regularization, and tree depth for a credit-default model. Track validation AUC for each trial, compare against the default configuration, and recommend the best setting only if it improves the baseline under the agreed trial budget.

### Example 2: Inference tuning

Tune retrieval depth, temperature, and reranker threshold for a RAG workflow. Optimize answer quality under a latency or cost ceiling, then report the best configuration with quality, latency, and cost tradeoffs.

### Example 3: Simulation or control

Tune controller gains or environment parameters for a simulator. Optimize reward or error while logging failed trials separately so unstable configurations do not bias the recommendation.

## Best Practices

- Keep the first run small; expand only after the loop produces useful signal.
- Prefer parameters with clear operational meaning over arbitrary knobs.
- Treat failed trials as data and record why they failed.
- Validate the final configuration on held-out data, a fresh seed, or a separate scenario before calling it robust.
- Ask before running expensive, long, or externally billed experiments.

## Limitations

- This skill does not guarantee a global optimum.
- Results depend on objective quality, noise, search-space design, and experiment reproducibility.
- Use domain review before applying tuned configurations to production, financial, safety-critical, or user-impacting systems.

## Additional Resources

- [Optim-Agent repository](https://github.com/Optim-Agent/optim-agent)
- [Optim-Agent documentation](https://optim-agent.github.io/optim-agent/)

Versions

RepositoryScoreLicence
This page · FrancoStino/opencode-skills-collection100MIT
Optim-Agent/optim-agent100MIT

Identical content appears in 3 other GitHub folders. We show one copy with the highest score.

Database snapshot: 13.11.2026 · package version aa0ffbf764d8 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100performant-ai
    Strategies for high-performance AI/LLM systems (Context Management, Prompt Engineering, RAG, Inference Tuning). Use when: ai, llm, performance, context window, tokens, prompt engineering, rag, inference, latency.
  • 100setup-guide
    Use when the user wants to set up inference-time scaling for the first time, or when its_hub is not yet installed/configured in the current environment.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.