Przejdź do treści
Biblioteka skilli
AI i agenci · Analiza

utility

/utility

Ocenia działania agenta według oczekiwanego zysku, kosztu, niepewności i redundancji, by zdecydować, czy uruchomić agenta lub wywołać narzędzie.

Licencja
MIT
Ostatnia zmiana repozytorium
01.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
8
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 01.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Ocenia działania agenta według oczekiwanego zysku, kosztu, niepewności i redundancji, by zdecydować, czy uruchomić agenta lub wywołać narzędzie.

Oryginalny opis (EN)

Scores agent actions by expected gain, cost, uncertainty, and redundancy. Use when deciding whether to dispatch an agent or invoke a tool.

Jak działa

  1. Overview
  2. When To Use
  3. When NOT to Use
  4. Action Space
  5. Utility Function
  6. Termination Conditions
  7. Quick Start
  8. Detailed Resources
  9. Exit Criteria
Sekcje z nagłówków SKILL.md, w oryginale · 111 linii, 567 słów
Podgląd SKILL.md
---
name: utility
description: Scores agent actions by expected gain, cost, uncertainty, and redundancy. Use when deciding whether to dispatch an agent or invoke a tool.
alwaysApply: false
category: infrastructure
tags:
- orchestration
- cost-control
- decision-making
- agent-dispatch
dependencies: []
provides:
  infrastructure:
  - utility-scoring
  - action-selection
  - termination-control
  patterns:
  - gain-estimation
  - cost-computation
  - redundancy-detection
usage_patterns:
- agent-dispatch-gating
- tool-call-decisions
- continuation-decisions
- model-tier-selection
complexity: intermediate
model_hint: standard
estimated_tokens: 600
progressive_loading: true
modules:
- modules/state-builder.md
- modules/gain.md
- modules/step-cost.md
- modules/uncertainty.md
- modules/redundancy.md
- modules/action-selector.md
- modules/integration.md
---
# Utility Skill

## Overview

A decision framework for agent orchestration based on Liu et al.,
"Utility-Guided Agent Orchestration for Efficient LLM Tool Use"
(arXiv:2603.19896).
Each candidate action is scored by subtracting weighted costs from
expected gain, producing a single utility value that guides action
selection.
The framework prevents over-calling tools and premature stopping by
making both errors costly.
Utility range is [-2.3, 1.0].

## When To Use

- Deciding whether to dispatch another agent or tool call
- Gating expensive tool calls (search, code execution, delegation)
- Selecting the right model tier for a sub-task
- Continuation decisions after receiving partial results
- Verification gating before writing or committing output

## When NOT to Use

- Single-step operations with one obvious action
- Trivial tasks where cost of scoring exceeds benefit
- Already-committed actions that cannot be undone

## Action Space

`A = {respond, retrieve, tool_call, verify, delegate, stop}`

| Action | Description |
|-----------|------------------------------------------------------|
| respond | Emit a final answer from current context |
| retrieve | Fetch additional information (search, read, lookup) |
| tool_call | Execute a tool (code runner, API, file write) |
| verify | Check a prior result for correctness or completeness |
| delegate | Spawn a sub-agent or hand off to a specialist |
| stop | Terminate the loop and return current state |

## Utility Function

```
U(a | s_t) = Gain(a | s_t)
           - λ₁ · StepCost(a | s_t)
           - λ₂ · Uncertainty(a | s_t)
           - λ₃ · Redundancy(a | s_t)
```

| Parameter | Default | Rationale |
|-----------|---------|---------------------------------------------------|
| λ₁ | 1.0 | Cost baseline; all other weights relative to this |
| λ₂ | 0.5 | Weak empirical correlation with outcome (r=0.0131) |
| λ₃ | 0.8 | Redundancy pruning yields ~10% token savings |

Utility range: **[-2.3, 1.0]**.
Positive values indicate the action is worth taking.
Values below the floor (-0.5 default) indicate the action should
be skipped.

## Termination Conditions

Stop the loop when **any** of the following is true:

- (a) Selected action is `stop`
- (b) Step budget exhausted (default: 10 steps)
- (c) All non-`stop` actions score below the floor (default: -0.5)

**High-gain override:** If `Gain >= 0.7` for any action, condition
(c) may be overridden.
Document the override and the gain value in your reasoning trace.

## Quick Start

Minimal 4-step advisory pattern:

1. **Construct state**: gather task context per
   `modules/state-builder.md`
2. **Score candidates**: evaluate each action in `A` per
   `modules/action-selector.md`
3. **Prefer highest utility**: select the action with the
   maximum `U(a | s_t)`, subject to termination conditions
4. **Log score and decision**: record the winning action,
   its utility value, and step count before executing

## Detailed Resources

- **State Builder**: `modules/state-builder.md`, how to
  populate `s_t` from task context
- **Gain**: `modules/gain.md`, estimating expected information
  or progress gain
- **Step Cost**: `modules/step-cost.md`, token, latency, and
  monetary cost tables
- **Uncertainty**: `modules/uncertainty.md`, confidence
  estimation and calibration
- **Redundancy**: `modules/redundancy.md`, detecting duplicate
  or low-delta actions
- **Action Selector**: `modules/action-selector.md`, scoring
  loop and tie-breaking rules
- **Integration**: `modules/integration.md`, wiring utility
  scoring into existing orchestration loops

## Exit Criteria

- [ ] State constructed with task goal and prior steps
- [ ] All six actions scored before selecting one
- [ ] Termination condition checked after each step
- [ ] Score and decision logged for each step taken
- [ ] High-gain overrides documented with gain value
Pliki w paczce (8)
  • SKILL.md 5 KB
  • modules/action-selector.md 3 KB
  • modules/gain.md 2 KB
  • modules/integration.md 4 KB
  • modules/redundancy.md 2 KB
  • modules/state-builder.md 3 KB
  • modules/step-cost.md 2 KB
  • modules/uncertainty.md 2 KB

Wersje

W bazie nie ma innych skilli o nazwie utility.

Migawka bazy z 13.11.2026 · wersja paczki 3fd2c0799376 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100skill-review
    Przegląda i ulepsza istniejący skill agenta pod kątem trafności wyzwalania, jakości treści, redundancji względem modelu bazowego oraz tego, czy skill faktycznie zmienia zachowanie.
  • 100rules-stocktake
    Audytuje reguły z ~/.claude/rules pod kątem kosztu rezydencji, nieaktualności, redundancji i wchłonięcia przez środowisko, i wydaje werdykt dla każdej reguły.
  • 100agent-tool
    Dodaje do agenta AI nową funkcję, którą model może wywołać, na przykład zapytanie do zewnętrznego API.
  • 100agentic-uncertainty-quantifier
    Ocenia niepewność zadania, by dobrać głębokość pamięci i liczbę iteracji agenta.
  • 96add-tool
    Dodaje nowe narzędzie do agenta OCFT, które pozwala mu odpytywać dane, liczyć reguły lub przeszukiwać dokumenty.
  • 100agent-evaluation
    Mierzy praktyczną wartość skilla na stałych zadaniach biznesowych w parach prób ze skillem i bez, z jawną punktacją oraz uczciwym raportem niepewności i kosztu.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.