FreePublished on GitHub

observability

Skill for the Observability area of paddock. 105 symbols across 26 files.

The English summary is being prepared. Showing the original description.

racecraft-lab/paddock-prototype

See how to install

Files included (1)

SKILL.md4.6 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Observability

105 symbols | 26 files | Cohesion: 93%

When to Use

Working with code in src/
Understanding how detectAegisStarvation, getCurrentEntitlement, runDailyRefresh work
Modifying observability-related functionality

Key Files

File	Symbols
`src/lib/observability/reconciler.ts`	now, tx, cursorKey, readCursor, writeCursor (+4)
`src/lib/provider-entitlement-detector.ts`	detect, sortProbesByPriority, getCurrentEntitlement, persistSnapshot, runProbeChain (+3)
`src/lib/observability/ingest-rate-state.ts`	now, readRow, narrowState, getIngestRateState, isAllowedIngestTransition (+3)
`src/lib/observability/ingest-admission.ts`	now, refillPerMs, refill, getBucket, diskBand (+1)
`src/lib/observability/otlp-receiver.ts`	resolveClientIp, isOver401Threshold, record401, errorBody, decompressBounded (+1)
`src/lib/observability/posted-effect.ts`	isAllowedPostedEffectTransition, loadEffectByCanonical, correctionsExistForCanonical, deriveState, getPostedEffectState (+1)
`src/lib/observability/dedupe.ts`	maxNullable, maxStringNullable, firstNonNullId, confidenceOf, mergeRawEvents (+1)
`src/lib/observability/correction-ledger.ts`	flushOne, appendCorrection, flushCorrection, flushDueCorrections, loadCanonicalCostAndId (+1)
`src/lib/observability/adapter-counters.ts`	key, recordAdapterCounter, getAdapterCounter, formatAdapterCountersAsProm, snapshotAdapterCounters (+1)
`src/lib/observability/self-obs-metrics.ts`	identity, normalizeLabels, incrementMetric, observeHistogram, getMetricsSnapshot

Entry Points

Start here when exploring this area:

detectAegisStarvation (Function) — src/lib/resource-aegis-starvation-detector.ts:77
getCurrentEntitlement (Function) — src/lib/provider-entitlement-detector.ts:136
runDailyRefresh (Function) — src/lib/provider-entitlement-detector.ts:229
runNearExpiryRefresh (Function) — src/lib/provider-entitlement-detector.ts:261
detectInline (Function) — src/lib/provider-entitlement-detector.ts:306

Key Symbols

Symbol	Type	File	Line
`detectAegisStarvation`	Function	`src/lib/resource-aegis-starvation-detector.ts`	77
`getCurrentEntitlement`	Function	`src/lib/provider-entitlement-detector.ts`	136
`runDailyRefresh`	Function	`src/lib/provider-entitlement-detector.ts`	229
`runNearExpiryRefresh`	Function	`src/lib/provider-entitlement-detector.ts`	261
`detectInline`	Function	`src/lib/provider-entitlement-detector.ts`	306
`incrementMetric`	Function	`src/lib/observability/self-obs-metrics.ts`	113
`observeHistogram`	Function	`src/lib/observability/self-obs-metrics.ts`	139
`getMetricsSnapshot`	Function	`src/lib/observability/self-obs-metrics.ts`	190
`getIngestRateState`	Function	`src/lib/observability/ingest-rate-state.ts`	145
`isAllowedIngestTransition`	Function	`src/lib/observability/ingest-rate-state.ts`	164
`transitionIngestRateState`	Function	`src/lib/observability/ingest-rate-state.ts`	181
`recordIngestDrop`	Function	`src/lib/observability/ingest-rate-state.ts`	236
`resetIngestDrops`	Function	`src/lib/observability/ingest-rate-state.ts`	253
`admitIngestion`	Function	`src/lib/observability/ingest-admission.ts`	155
`tx`	Function	`src/app/api/governance/ingest/[source]/resume/route.ts`	95
`handleOtlpRequest`	Function	`src/lib/observability/otlp-receiver.ts`	140
`decodeOtlpTraces`	Function	`src/lib/observability/otlp-decoder.ts`	59
`decodeOtlpMetrics`	Function	`src/lib/observability/otlp-decoder.ts`	78
`POST`	Function	`src/app/api/otlp/v1/metrics/route.ts`	17
`POST`	Function	`src/app/api/otlp/v1/traces/route.ts`	18

Execution Flows

Flow	Type	Steps
`POST → NormalizeLabels`	cross_community	4
`POST → Identity`	cross_community	4
`POST → NormalizeLabels`	cross_community	4
`POST → Identity`	cross_community	4

Connected Areas

Area	Connections
Cluster_176	2 calls
Cluster_200	2 calls
Cluster_183	1 calls
[id]	1 calls

How to Explore

gitnexus_context({name: "detectAegisStarvation"}) — see callers and callees
gitnexus_query({query: "observability"}) — find related execution flows
Read key files listed above for implementation details

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

More skills from this repository

adapters

Free

Skill for the Adapters area of paddock. 108 symbols across 22 files.

The English summary is being prepared. Showing the original description.

racecraft-lab/paddock-prototype12Updated Jun 26, 2026

chat

Free

Skill for the Chat area of paddock. 62 symbols across 10 files.

The English summary is being prepared. Showing the original description.

racecraft-lab/paddock-prototype12Updated Jun 26, 2026

dashboard

Free

Skill for the Dashboard area of paddock. 80 symbols across 16 files.

The English summary is being prepared. Showing the original description.

racecraft-lab/paddock-prototype12Updated Jun 26, 2026

github

Free

Skill for the Github area of paddock. 23 symbols across 5 files.

The English summary is being prepared. Showing the original description.

racecraft-lab/paddock-prototype12Updated Jun 26, 2026

Use when the user needs to run GitNexus CLI commands like analyze/index a repo, check status, clean the index, generate a wiki, or list indexed repos. Examples: "Index this repo", "Reanalyze the codebase", "Generate a wiki"

The English summary is being prepared. Showing the original description.

racecraft-lab/paddock-prototype12Updated Jun 26, 2026

gitnexus-debugging

Free

Use when the user is debugging a bug, tracing an error, or asking why something fails. Examples: "Why is X failing?", "Where does this error come from?", "Trace this bug"

The English summary is being prepared. Showing the original description.

racecraft-lab/paddock-prototype12Updated Jun 26, 2026

See all skills by racecraft-lab

Report a problem with this skill

Install

Install with a command

npx skills add https://github.com/racecraft-lab/paddock-prototype --skill observability

Paste it into your terminal and run it (requires Node.js). You can choose which agents to install it for, such as Claude Code or Codex.

Ask your agent

Please install the following Agent Skill.
https://github.com/racecraft-lab/paddock-prototype/tree/main/.claude/skills/generated/observability

First review SKILL.md and the bundled files and confirm there is nothing suspicious (such as sending data externally or reading credentials). Then place it in ~/.claude/skills/observability/ for Claude Code, or ~/.agents/skills/observability/ for Codex.

Send this text to Claude Code or Codex as is. It checks the contents before installing.

View source on GitHub

Repository: racecraft-lab/paddock-prototype
Stars: 12
Forks: 1
Category: DevOps
License: MIT
Original language: English
Last updated: Jun 26, 2026

A skill is a set of instructions and scripts for an agent. cccskills does not guarantee that skills are safe. Review the contents before you install.

Files included (1)

SKILL.md (original)

Observability

When to Use

Key Files

Entry Points

Key Symbols

Execution Flows

Connected Areas

How to Explore

Reviews

Comments

More skills from this repository

adapters

chat

dashboard

github

gitnexus-cli

gitnexus-debugging