Przejdź do treści
Biblioteka skilli
DevOps i chmura · Integracja z narzędziem

setup

/setup

Prowadzi przez pierwszą konfigurację Sherlock Holmes w Grafanie: sprawdza dostęp, znajduje źródła Loki i Tempo oraz weryfikuje wynik.

Repozytorium
claude-plugins ↗
Licencja
MIT
Ostatnia zmiana repozytorium
25.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
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 25.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

Prowadzi przez pierwszą konfigurację Sherlock Holmes w Grafanie: sprawdza dostęp, znajduje źródła Loki i Tempo oraz weryfikuje wynik.

Argumenty

/setup [--fixture]
Oryginalny opis (EN)

Guided first-run setup for Sherlock Holmes, in one conversation - checks Grafana access with the doctor, discovers the Loki and Tempo datasource UIDs, proposes the Loki stream selector from the labels your Loki really has, hands over the exact /config values, optionally installs archify for the trace diagram, and verifies the result. Use right after installing the plugin, whenever the doctor reports a configuration problem, or when the user asks how to configure or set up Sherlock Holmes. Changes nothing in production.

Jak działa

  1. 0. What this installation already has
  2. 1. Doctor
  3. 2. Hand over the configuration
  4. 3. Diagram (optional)
  5. 4. First investigation
  6. 5. Close
Sekcje z nagłówków SKILL.md, w oryginale · 138 linii, 1 183 słów
Podgląd SKILL.md
---
name: setup
description: Guided first-run setup for Sherlock Holmes, in one conversation - checks Grafana access with the doctor, discovers the Loki and Tempo datasource UIDs, proposes the Loki stream selector from the labels your Loki really has, hands over the exact /config values, optionally installs archify for the trace diagram, and verifies the result. Use right after installing the plugin, whenever the doctor reports a configuration problem, or when the user asks how to configure or set up Sherlock Holmes. Changes nothing in production.
argument-hint: "[--fixture]"
allowed-tools: Bash(python3 *collect-trace.py*) Bash(python3 *trace-diagram.py*) Read Bash(python *collect-trace.py*) Bash(py -3 *collect-trace.py*) Bash(python *trace-diagram.py*) Bash(py -3 *trace-diagram.py*)
---

# Setup

Take the user from "plugin installed" to "first investigation" with as little hunting as possible.
Everything below is read-only except one thing: installing archify, and only after the user says yes
to that exact command. You never write files, never print a credential and never put one on a command
line. Run the collector's `doctor` at most three times in a session.

`$ARGUMENTS` may contain `--fixture`: then run every doctor in fixture mode with
`--fixture "${CLAUDE_PLUGIN_ROOT}/evals/fixtures/01-downstream-503"` to demonstrate the flow without
a backend, and say so.

## 0. What this installation already has

- Grafana URL: `${user_config.grafana_url}`
- Loki datasource UID: `${user_config.grafana_loki_uid}`
- Tempo datasource UID: `${user_config.grafana_tempo_uid}`
- Loki selector: `${user_config.loki_selector}`
- Trace-id filter mode: `${user_config.loki_trace_filter}`
- Trace-id field: `${user_config.loki_trace_field}`

A blank value or an unreplaced `${...}` placeholder means "not set". Pass the set ones to the doctor
as `--grafana-url`, `--grafana-loki-uid`, `--grafana-tempo-uid`, `--selector`, `--trace-filter`,
`--trace-field`.

**Python command.** The commands below start with `python3`. If the shell answers "command not
found", or `python3` opens the Microsoft Store (Windows, where the python.org installer provides
`python` and `py` instead), run the same command with `python` in place of `python3` - or `py -3` -
and change nothing else; keep using that one for the rest of the session. If none of the three
exists, stop and tell the user: install Python 3.8+ (on Windows from python.org, ticking "Add
python.exe to PATH"), then fully close and reopen the editor or terminal that runs Claude Code, since
it reads PATH only when it starts.

## 1. Doctor

```bash
python3 "${CLAUDE_PLUGIN_ROOT}/skills/trace-debug/scripts/collect-trace.py" doctor [config flags]
```

One command, exactly that shape. Read its JSON. Start with `setup`: `python` (the interpreter
and version that ran), `settings` (each value, whether it is set and from where - `/config` or the
environment; the token's value is never shown) and `next`, the one next step. Show the user the
`settings` block as it is and follow `next`, then branch on the rest:

- **Both sources `access: none`** ("not configured"): nothing is wired yet. Explain the two routes and
  let the user pick: through Grafana (`GRAFANA_URL` + `GRAFANA_TOKEN`, a service account with the
  Viewer role is enough - *Administration → Users and access → Service accounts*), or directly
  (`LOKI_URL`/`TEMPO_URL` with `LOKI_TOKEN`/`TEMPO_TOKEN` or basic auth). The token is the one value
  `/config` must not carry. Recommend the `env` block of the user's own Claude Code settings file -
  `~/.claude/settings.json`, on Windows `%USERPROFILE%\.claude\settings.json` - because it works the
  same in the terminal, VS Code and JetBrains, on every OS, and a new conversation picks it up with no
  editor restart:

  ```json
  {
    "env": {
      "GRAFANA_URL": "https://your-stack.grafana.net",
      "GRAFANA_TOKEN": "<your service account token>"
    }
  }
  ```

  Merge it into the file if one exists; never overwrite other keys. Say plainly that the file stores
  the token as plain text in the user's profile, and that it must never go in a project's
  `.claude/settings.json`, which is usually committed. The alternative is an OS environment
  variable (`export` in the shell, or Windows *Environment Variables*); it is read only when the
  editor starts, so VS Code must be fully closed and reopened. Use placeholders, never a value you
  invented, and end this step with: save, open a new conversation, run `/sherlock-holmes:setup` again.
- **HTTP 401 / 403**: the credential is wrong, expired or lacks the Viewer role. Name the variable to
  fix. Do not guess at datasources.
- **`grafana_datasources` present**: the URL and token work. Pick the Loki and the Tempo entries. One of
  each: take them. Several: show the list and ask which belong to the environment being investigated.
- **Loki `check: ok` with `labels_sample`**: propose the selector from labels that really exist there.
  Prefer, in this order, `namespace`, `env`/`environment`, `cluster`, `app`/`service_name`. A selector
  needs a value, and the doctor lists only label names: ask the user for the value (for example
  `{namespace="prod"}`), never invent one, and never propose `{}` - the collector refuses it.
- **Trace-id filter**: keep `substring` unless the user says their logs are JSON with a trace-id field
  or use Loki 3 structured metadata; then propose `json` or `metadata` and ask for the field name
  (`trace_id`, `traceId`, `traceID` are the common ones).

## 2. Hand over the configuration

Give the values ready to paste. The recommended place for everything except the token is `/config`
→ Plugins → Sherlock Holmes, one line per field: `grafana_url`, `grafana_loki_uid`,
`grafana_tempo_uid`, `loki_selector`, `loki_trace_filter`, `loki_trace_field`. It works the same when
the plugin was installed by the user or by the organization (a zip or a synced repository): the
values belong to each user. The same values also work as variables in the `env` block of
`~/.claude/settings.json` - `GRAFANA_URL`, `GRAFANA_LOKI_UID`, `GRAFANA_TEMPO_UID`, `LOKI_SELECTOR`,
`LOKI_TRACE_FILTER`, `LOKI_TRACE_FIELD` - for people who keep everything in one place.
When both are set, `/config` wins.

Neither the skill nor you can write these settings: that is the user's step, by design of the plugin
system. Say so in one sentence. Then run the doctor again: `settings` must show every value `set`
and `next` must say `none`.

## 3. Diagram (optional)

```bash
python3 "${CLAUDE_PLUGIN_ROOT}/skills/trace-debug/scripts/trace-diagram.py" doctor
```

- `diagram: ok`: say so and move on.
- `node not found` or a Node older than 18: the diagram needs Node, and the archify installer needs
  Node 22+ (`npx skills add` fails on 18 with `does not provide an export named 'styleText'`). Say
  it, do not install Node, and give the one line: install the LTS from nodejs.org, or `nvm install
  --lts` on macOS/Linux - not the Linux distribution package, which is often older - then fully close
  and reopen the editor or terminal (PATH is read at start). Move on; everything else works without
  the diagram.
- `archify not found` and a Node older than 22: same advice before offering the install command,
  since the installer would fail.
- `archify not found`: explain in two lines what the diagram is (the trace as a self-contained
  interactive HTML, evidence only, delivered with every investigation that has a trace in Tempo) and
  **ask** whether to install archify now with exactly:

  ```bash
  npx skills add tt-a1i/archify -g
  ```

  Only after an explicit yes run that command. It is not pre-approved on purpose: the permission
  prompt the user sees is the consent. Mention that it also installs a companion skill,
  `archify-review`, which this plugin does not use. Then run the diagram doctor again and report the
  path it found. If the user says no, or later, tell them the command and that `Run the trace-debug
  doctor` will show `diagram: available` once it is done.

## 4. First investigation

- Backend configured and verified: suggest `/sherlock-holmes:trace-debug <trace-id>` with a trace the
  user already understands, so they can judge the report.
- Nothing configured yet, or the user wants to see it first: suggest, verbatim,
  *Investigate trace `2aa803b2e40c97a2490d754a465fe9de` using the bundled fixtures for
  `01-downstream-503`* - recorded Loki and Tempo responses, no backend needed.

## 5. Close

End with a short checklist in the user's language: what is verified (sources, UIDs, selector,
diagram) and what is still on the user (the token in settings.json, `/config` values). Nothing else: no
speculation about their system, no changes proposed to it.

Wersje

RepozytoriumWynikLicencja
Ta strona · whitebeardit/claude-plugins100MIT
HwangSlater/harness-fit100MIT
nesquikm/dev-process-toolkit100MIT
userKael/rastro100MIT
als-apg/osprey100BSD-3-Clause
dedujeong/gemba100Apache-2.0
eigenwise/eigenwise-toolshed100MIT
awrshift/agent-memory-kit100MIT
lifecycle-innovations-limited/claude-ops100MIT

Migawka bazy z 13.11.2026 · wersja paczki 9eaa32b1a257 (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

  • 100trace-debug
    Bada incydent produkcyjny na podstawie ID śladu w logach Loki i trasach Tempo, wskazuje pierwsze nietypowe zdarzenie i braki w danych.
  • 100loki-configuration-validation
    Waliduje konfigurację Loki przed wdrożeniem: wartości limits_config, ustawienia schema_config i storage oraz założenia o kardynalności etykiet przez dry-run, aby zła konfiguracja nie odrzucała ani nie gubiła logów produkcyjnych.
  • 100grafana
    Wspiera pracę z Grafana: dashboardy, panele PromQL i LogQL, reguły alertów, źródła danych oraz Loki i Tempo, przy wizualizacji metryk i logów.
  • 90grafana
    Podpowiada Grafanę 12.x: projektowanie dashboardów, panele, zmienne, alerty, Loki i Tempo, provisioning oraz uprawnienia.
  • 100loki-label-analyzer
    Ocenia strategię etykiet Grafana Loki: audytuje, projektuje i poprawia schematy etykiet przez ocenę kardynalności i zgodność ze wzorcami dostępu, także gdy zapytania są wolne.
  • 100loki
    Pomaga uruchomić Loki, skalowalny system agregacji logów Grafana Labs indeksujący tylko etykiety: wysyłanie logów Dockera, zapytania LogQL, zamiana Promtail na Alloy i logi w Grafanie.

Uwagi i zgłoszenia

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