Agent skill

Observability

Observability best practices. An agent skill from 2SSK/dot-files.

Install Observability

skills CLI

$ npx skills add 2SSK/dot-files --skill observability -a claude-code

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

GitHub CLI

$ gh skill install 2SSK/dot-files observability --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/2SSK/dot-files.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/observability .claude/skills/observability && 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/

Paste into Claude Code

Install the "observability" agent skill from https://github.com/2SSK/dot-files/tree/main/.claude/skills/observability into .claude/skills/observability/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "observability", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/2SSK/dot-files/tree/main/.claude/skills/observability

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add 2SSK/dot-files --skill observability -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install 2SSK/dot-files observability --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/2SSK/dot-files.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/observability .agents/skills/observability && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "observability" agent skill from https://github.com/2SSK/dot-files/tree/main/.claude/skills/observability into .agents/skills/observability/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "observability", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add 2SSK/dot-files --skill observability -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install 2SSK/dot-files observability --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/2SSK/dot-files.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/observability .cursor/skills/observability && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "observability" agent skill from https://github.com/2SSK/dot-files/tree/main/.claude/skills/observability into .cursor/skills/observability/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "observability", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/2SSK/dot-files.git --path .claude/skills/observability

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add 2SSK/dot-files --skill observability -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install 2SSK/dot-files observability --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/2SSK/dot-files.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/observability .gemini/skills/observability && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "observability" agent skill from https://github.com/2SSK/dot-files/tree/main/.claude/skills/observability into .gemini/skills/observability/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "observability", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install 2SSK/dot-files observability

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add 2SSK/dot-files --skill observability -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/2SSK/dot-files.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/observability .github/skills/observability && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "observability" agent skill from https://github.com/2SSK/dot-files/tree/main/.claude/skills/observability into .github/skills/observability/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "observability", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add 2SSK/dot-files --skill observability -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install 2SSK/dot-files observability --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/2SSK/dot-files.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/observability .opencode/skills/observability && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "observability" agent skill from https://github.com/2SSK/dot-files/tree/main/.claude/skills/observability into .opencode/skills/observability/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "observability", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: observability
GitHub stars: 247
Token cost: ~676 tokens
SKILL.md length: 101 words
Files: 1
Skills in repo: 7
Repo updated: Sep 12, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Observability best practices. An agent skill from 2SSK/dot-files.

Works in 3 steps: Logging → Metrics → Tracing
Any backend service
SKILL.md covers The Three Pillars, SLI/SLO Definitions, Health Checks and Alerting, plus 1 more section
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Observability is an agent skill from 2SSK/dot-files. Observability best practices. Logging, metrics, tracing, alerting. Essential for production services. Use for any backend service.

Its SKILL.md is about 680 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: opencode

It sits in DevOps & Cloud, covering Observability and Site reliability engineering. The licence is MIT.

When your agent uses it

Any backend service
Tasks that involve Observability
Tasks that involve Site reliability engineering

Example prompts

“/observability”

Requirements

Node.js
Compatibility (from SKILL.md): opencode

Workflow steps

3 steps, taken from the step headings in SKILL.md.

Logging
Metrics
Tracing

What it can do on your machine

Read from SKILL.md and the folder at commit 5cab3b1. 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 (its code samples are go).
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.
Compatibility
opencode
From compatibility in the SKILL.md frontmatter.

Context cost

Observability loads about 676 tokens when it runs. Until then it costs about 36 tokens; SKILL.md has 101 words of instructions outside code blocks.

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

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 2SSK/dot-files at commit 5cab3b1, republished under its MIT licence (© 2SSK). 101 words, ~676 tokens.

Download SKILL.mdSave it as .claude/skills/observability/SKILL.md (or your agent's skills folder).

name: observability
description: Observability best practices. Logging, metrics, tracing, alerting. Essential for production services. Use for any backend service.
compatibility: opencode

Observability Best Practices

Structured logging, metrics, distributed tracing, and alerting for production systems.

The Three Pillars

1. Logging

// Go: slog for structured logging
import "log/slog"

slog.Info("request completed",
    "method", r.Method,
    "path", r.URL.Path,
    "duration_ms", duration.Milliseconds(),
    "status", statusCode,
)

// Node.js: pino
import pino from 'pino';

const logger = pino({
  level: 'info',
  formatters: {
    level: (label) => ({ level: label }),
  },
});

2. Metrics

// Prometheus metrics
import "github.com/prometheus/client_golang/prometheus"

var requestDuration = prometheus.NewHistogramVec(
    prometheus.HistogramOpts{
        Name:    "http_request_duration_seconds",
        Help:    "HTTP request duration in seconds",
        Buckets:  []float64{.005, .01, .025, .05, .1, .25, .5, 1, 2.5, 5},
    },
    []string{"method", "path", "status"},
)

var activeRequests = prometheus.NewGauge(prometheus.GaugeOpts{
    Name: "active_requests",
    Help: "Number of active requests",
})

3. Tracing

// OpenTelemetry
import "go.opentelemetry.io/otel"
import "go.opentelemetry.io/otel/trace"

func Handler(ctx context.Context, w http.ResponseWriter, r *http.Request) {
    ctx, span := otel.Tracer("http").Start(ctx, r.URL.Path)
    defer span.End()
    
    // business logic
    span.SetAttributes(
        attribute.String("http.method", r.Method),
        attribute.Int("http.status_code", statusCode),
    )
}

SLI/SLO Definitions

Latency

SLI: p99 latency < 100ms
SLO: 99.9% of requests

Availability

SLI: Request success rate > 99.9%
SLO: < 0.1% error budget consumed per month

Quality

SLI: Successful responses with no errors
SLO: Error rate < 0.1%

Health Checks

// Liveness: process is running
// Readiness: service can handle requests
http.HandleFunc("/healthz", func(w http.ResponseWriter, r *http.Request) {
    // check dependencies
    if !db.Healthy() {
        http.Error(w, "db unhealthy", http.StatusServiceUnavailable)
        return
    }
    w.WriteHeader(http.StatusOK)
})

Alerting

Warning: SLO breach at 50% budget
Critical: SLO breach at 80% budget
Page: SLO breach at 95% budget

Quality Gates

Structured logs with request ID, user ID
Prometheus metrics exported
Distributed tracing configured
Health check endpoints
Alerting rules defined
SLO dashboard

Files

Just SKILL.md in .claude/skills/observability of 2SSK/dot-files.

Open the folder on GitHubat commit 5cab3b1

Compare with similar skills

Observability 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.

Observability compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Observability this skill2SSK/dot-files	247	—	~676	Automated safety check: Pass	MIT	26 days ago
Service Mesh Observabilitywshobson/agents	40k	9 repos	~607	Automated safety check: Pass	MIT	3 days ago
Monitoring Observabilityahmedasmar/devops-claude-skills	203	—	~3.9k	Automated safety check: Pass	None	5 mo ago
Prometheus Error Rate Investigatorprometheus/prometheus-mcp	118	—	~592	Automated safety check: Pass	Apache-2.0	3 days ago
Error HandlerEliasOulkadi/shokunin	114	—	~3.6k	Automated safety check: Notes	MIT	3 days ago
Observability Engineerdavila7/claude-code-templates	32k	8 repos	~3.2k	Automated safety check: Pass	MIT	today

Similar skills

Service Mesh Observability
wshobson/agents
Set up tracing, metrics and dashboards for Istio, Linkerd and other service meshes, with golden-signal alerts, SLOs and guidance on sampling and cardinality.
40k GitHub starsUsed in 9 repos~607 tokens
DevOps & CloudAuto-check passed
Monitoring Observability
ahmedasmar/devops-claude-skills
Monitoring and observability strategy, implementation, and troubleshooting.
203 GitHub stars~3.9k tokensUpdated 5 mo ago
DevOps & CloudAuto-check passed
Prometheus Error Rate Investigator
prometheus/prometheus-mcp
Quantifies elevated error rates with PromQL, compares them to a baseline, and isolates which jobs or instances an error spike is concentrated in.
118 GitHub stars~592 tokensUpdated 3 days ago
DevOps & CloudAuto-check passed
Error Handler
EliasOulkadi/shokunin
Design error handling, structured logging, and observability with OpenTelemetry (traces, metrics, logs), error classification, recovery patterns (retry with jitter, circuit breaker, bulkhead…
114 GitHub stars~3.6k tokensUpdated 3 days ago
DevOps & CloudAuto-check: notes
Observability Engineer
davila7/claude-code-templates
Build production-ready monitoring, logging, and tracing systems.
32k GitHub starsUsed in 8 repos~3.2k tokens
DevOps & CloudAuto-check passed
Incident Responder
davila7/claude-code-templates
Expert SRE incident responder specializing in rapid problem resolution, modern observability, and comprehensive incident management.
32k GitHub starsUsed in 7 repos~2.6k tokens
DevOps & CloudAuto-check passed

Questions about Observability

What does Observability do?

Observability best practices. An agent skill from 2SSK/dot-files. Observability is an agent skill from 2SSK/dot-files. Observability best practices.

When should I use Observability?

Observability fits situations like: any backend service; tasks that involve Observability; tasks that involve Site reliability engineering.

How do I install Observability in Claude Code?

Run `npx skills add 2SSK/dot-files --skill observability -a claude-code`. Or copy the skill folder (.claude/skills/observability in 2SSK/dot-files) into .claude/skills/observability in your project. Claude Code loads it when a task matches its description.

How do I install Observability in Codex?

Run `npx skills add 2SSK/dot-files --skill observability -a codex`. Or copy the skill folder (.claude/skills/observability in 2SSK/dot-files) into .agents/skills/observability in your project. Codex loads it when a task matches its description.

Can I use Observability 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 2SSK/dot-files --skill observability -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/observability, .gemini/skills/observability, .github/skills/observability and .opencode/skills/observability in your project.

What does Observability need to run?

SKILL.md names no scripts, command-line tools or credentials: Observability is instructions for the agent only. Our summary lists: Node.js. Compatibility (from SKILL.md): opencode.

Does Observability 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 Observability 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 Observability use?

Observability 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 Observability use?

About 676 tokens (SKILL.md is roughly 2.7k 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 Observability?

Skills that share tags, products or a category with Observability: Service Mesh Observability (wshobson/agents, 40k stars), Monitoring Observability (ahmedasmar/devops-claude-skills, 203 stars), Prometheus Error Rate Investigator (prometheus/prometheus-mcp, 118 stars) and Error Handler (EliasOulkadi/shokunin, 114 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Observability?

2SSK (a GitHub user) maintains it in 2SSK/dot-files, which has 247 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on September 12, 2026.

Source: 2SSK/dot-files on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Observability

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Compatibility

Context cost

Safety

SKILL.md

Observability Best Practices

The Three Pillars

1. Logging

2. Metrics

3. Tracing

SLI/SLO Definitions

Latency

Availability

Quality

Health Checks

Alerting

Quality Gates

Files

Compare with similar skills

Similar skills

More from 2SSK/dot-files

Related

Questions about Observability