token-budget

Token budget tracking and enforcement for Gastown convoy-level execution. Hard limits with pre-execution checking, per-convoy and per-agent tracking, structured stop reasons.

Aller à l'installation

Dépôt: Tibsfox/gsd-skill-creator
Dernière activité de la source: 9 mai 2026 à 16:42
Langue détectée de SKILL.md: anglais
Étoiles: 69
Forks: 9

Options d'installation

Le prompt qui vérifie d'abord la source est sélectionné par défaut. Vous pouvez passer à une commande directe ou télécharger une copie locale.

Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.

Une commande directe contourne le prompt de vérification. Examinez la source avant de l'exécuter.

npx skills add https://github.com/Tibsfox/gsd-skill-creator --skill token-budget

La commande reste sur une seule ligne. Faites défiler horizontalement pour la vérifier avant de la copier.

Vous préférez une copie locale ? Téléchargez les fichiers actuellement disponibles dans SkillsMP.

Vérifiez les fichiers source

Lisez SKILL.md et les fichiers associés affichés par SkillsMP avant de décider de l'installer.

SKILL.md

Instructions source · Aperçu en lecture seule

Retour à la recherche Retour à l’installation

goal-ambiguity-gate

Use the moment a request is underspecified and you are about to act on an ASSUMED goal. Enumerate the candidate goals the request could mean, project the action or artifact each one implies, and check whether they diverge: if two or more plausible goals lead to materially different actions or artifacts, ask exactly ONE targeted clarifying question; otherwise proceed on the most-likely goal and state the assumption in one line. Clarification is an evidence-producing action, not a delay — but one question, never an interrogation. Distinct from gsd-spec-phase (GSD-phase-bound, emits a heavy SPEC.md) and intent-router (fetch strategy, not goal disambiguation). Backed by agent goal-state inference (arxiv 2606.16813v1). Triggers on acting under an assumed goal when the request admits more than one materially different reading.

2026-07-19

memory-hubness-gate

Use at write time to vector/embedding memory — Grove content-addressed insertion, chroma/pgvector upserts, memory-consolidation promoting session traces to MEMORY.md, or embedding externally-ingested content. Scores each candidate record against a fixed panel of sentinel queries and quarantines any record that would become the nearest neighbor of too many unrelated queries — a hub — whether from adversarial poisoning or accidental over-generality. This is the memory-record-side sibling of skill-injection-guardian (file-side) and the write-side complement of memory-use-warrant (read-side). Quarantine, never silently drop; a human reviews. Backed by the admission-time hubness gate (arxiv 2606.19692v1). Triggers on inserting into vector memory, consolidating memory, and embedding stranger content.

2026-07-19

memory-use-warrant

Run this appropriateness check the moment you are about to integrate a retrieved long-term memory — a Grove content-addressed hit, a chroma/pgvector neighbour, a memory-consolidation digest, or a MEMORY.md line — into a response, especially anything touching private origins, Fox Companies IP, credentials, or Center Camp / consent-governed content. It answers a question intent-router never asks: not WHAT to fetch or HOW, but WHETHER a correctly-retrieved item should reach output. Relevance is not appropriateness — a perfect similarity match can still be a boundary violation. Default is FAIL-CLOSED: if in-context authorization is uncertain, the memory may inform behaviour but must not be surfaced. Backed by RBI-Eval (arxiv 2606.06055v1). Triggers on surfacing recalled sensitive memory into a response.

2026-07-19

Tout voir dans ce dépôt

name	token-budget
description	Token budget tracking and enforcement for Gastown convoy-level execution. Hard limits with pre-execution checking, per-convoy and per-agent tracking, structured stop reasons.
type	skill
category	state
status	stable
origin	tibsfox
modified	false
first_seen	"2026-04-04T00:00:00.000Z"
first_path	.claude/skills/token-budget/SKILL.md
superseded_by	null

Reason	Meaning	Action
`ok`	Under budget, no concerns	Proceed
`warning_threshold`	Past warning % but under hard limit	Proceed, log warning
`convoy_budget_exceeded`	Convoy would exceed hard limit	STOP, do not call API
`agent_budget_exceeded`	Agent would exceed its limit	STOP, do not call API

name	token-budget
description	Token budget tracking and enforcement for Gastown convoy-level execution. Hard limits with pre-execution checking, per-convoy and per-agent tracking, structured stop reasons.
type	skill
category	state
status	stable
origin	tibsfox
modified	false
first_seen	"2026-04-04T00:00:00.000Z"
first_path	.claude/skills/token-budget/SKILL.md
superseded_by	null

Reason	Meaning	Action
`ok`	Under budget, no concerns	Proceed
`warning_threshold`	Past warning % but under hard limit	Proceed, log warning
`convoy_budget_exceeded`	Convoy would exceed hard limit	STOP, do not call API
`agent_budget_exceeded`	Agent would exceed its limit	STOP, do not call API

Function	Signature	Description
`createBudget`	`(convoyId, config?) => TokenBudget`	Initialize a budget for a convoy
`checkBudget`	`(budget, agentId, projectedCost) => BudgetCheckResult`	Pre-execution gate check
`recordUsage`	`(budget, agentId, input, output) => void`	Track actual usage after execution
`getBudgetReport`	`(budget) => BudgetReport`	Summary for logging/display
`saveBudget`	`(budget, budgetDir) => Promise<void>`	Persist to `.chipset/state/budgets/`
`loadBudget`	`(convoyId, budgetDir) => Promise<TokenBudget \| null>`	Load from disk
`deleteBudget`	`(convoyId, budgetDir) => Promise<void>`	Remove budget file
`listBudgets`	`(budgetDir) => Promise<string[]>`	List all persisted convoy budget IDs

token-budget

Options d'installation

Vérifiez les fichiers source

Token Budget Enforcement

Activation

Architecture

Budget Hierarchy

Check-Before-Execute Pattern

Structured Stop Reasons

Token Budget Enforcement

Activation

Architecture

Budget Hierarchy

Check-Before-Execute Pattern

Structured Stop Reasons

Core API

Types

Functions

Default Values

State Persistence

Integration Points

Mayor Coordinator

Polecat Worker

Witness Observer

Module Location

Parameter	Default	Recalibration note
`maxTokensPerConvoy`	500,000 tokens	Was set conservatively pre-INLINE-SERIAL pattern. v1.49.621 actuals: ~50-300K per convoy under inline-serial Opus/Sonnet authoring (~10-15% of this default). Default retained for safety margin; missions may explicitly cap lower based on convoy shape.
`maxTokensPerAgent`	100,000 tokens	Pre-recursive-spawn-block default; with INLINE SERIAL the agent IS the convoy, so per-agent ≈ per-convoy.
`warningThresholdPercent`	80%	Unchanged.

token-budget

Informations de source

Options d'installation

Vérifiez les fichiers source

Plus depuis ce dépôt

Plus depuis ce dépôt

Token Budget Enforcement

Activation

Architecture

Budget Hierarchy

Check-Before-Execute Pattern

Structured Stop Reasons

Token Budget Enforcement

Activation

Architecture

Budget Hierarchy

Check-Before-Execute Pattern

Structured Stop Reasons

Core API

Types

Functions

Default Values

State Persistence

Integration Points

Mayor Coordinator

Polecat Worker

Witness Observer

Module Location