---
title: Oskuste kogu korrastamine
description: Auditeerib ja korrastab oskuste kogu ning ühtlustab nimetamise.
category: Marketing
sublabel: SEO
author: OpenClaudia
tags: 
license: MIT
source: https://github.com/OpenClaudia/openclaudia-skills
---

# Oskuste korraldamine

Korralda oskustekogu ümber nii, et nimed kodeerivad, mida iga oskus tegelikult puudutab, ning hoia symlink’id ja
ristviited ümbernimetamisel järjepidevad.

Paljudes seadistustes on ÜKS kanooniline oskustekogu jagatud kataloogis ja see on symlinkitud iga tööriista hub’i
(nt `~/.claude/skills/`, `~/.codex/skills/`). Mõned oskused elavad projekti repos ja on
hub’i symlinkitud. Üks ümbernimetamine võib seega puudutada mitut symlink’i ning iga dokumenti, mis
viitab vanale nimele — seda hajumist see oskus haldab.

## Samm 1 — Inventuur

Loetle iga oskus ja kus see tegelikult elab. Hub’i kirje on tavaliselt symlink kanoonilisele kataloogile:

```bash
for hub in <hub-1> <hub-2>; do
  echo "== $hub =="; ls -la "$hub"
done
```

Lahenda iga nimi tegelikuks kataloogiks käsuga `readlink -f`. Märgi, millised oskused elavad projekti repos
versus jagatud kogus — repo-siseste ümbernimetamiste jaoks peab selles repos kasutama `git mv`.

## Samm 2 — Klassifitseeri backend’i järgi (nimetamisreegel)

Konventsioon: **eesliide nimetab backend’i, millest oskus sõltub**, otsustatud selle järgi, mida see tegelikult
kutsub, mitte teema järgi. Otsi igast oskusekataloogist iseloomulikku sõltuvust:

```bash
grep -rlE "<api-host>/api|/api/<x>|<db-client>|<AUTH_TOKEN_NAME>" "$skill_dir"
```

- Kutsub konkreetse toote API-d / andmebaasi → selle toote eesliide (nt `acme-*`).
- Puhtalt kohalik (brauseri automatiseerimine, offline SOP, failitöötlus, backend’ita) → üldine/kohalik eesliide.
- Hoia temaatilist infiksi, kui perekond on suur (nt `acme-seo-*` vs `acme-reddit-*`), et seotud oskused sorteeruksid koos.

Esita klassifikatsioon kasutajale enne ümbernimetamist. Oskus, mis *tundub* tootespetsiifiline, aga
ei tee ühtegi backend-kutset, kuulub kohalikku korvi, ja vastupidi — mine sõltuvuse järgi.

## Samm 3 — Nimeta ümber (ja paranda kõik, mida ümbernimetamine katkestab)

Iga ümbernimetamise `OLD → NEW` jaoks:

1. **Teisalda kanooniline kataloog.**
   - Jagatud kogus: `mv <lib>/OLD <lib>/NEW`
   - Repo-sisene: `cd <repo> && git mv <skills-path>/OLD <skills-path>/NEW && git commit`
   - Valesti paigutatud valesse reposse? Teisalda see jagatud kogusse, mitte lihtsalt ümber nimetades kohapeal.
2. **Ühenda symlink’id igas hub’is ümber.** Eemalda aegunud link, loo uus, mis osutab
   kanoonilisele kataloogile. Tee seda iga tööriista hub’i jaoks, mis peegeldab kogu.
3. **Uuenda `name:` frontmatter** failis `NEW/SKILL.md`, et see vastaks kataloogile — laadija võtmeks on
   see, mitte kausta nimi.
4. **Paranda ristviited.** Teised oskused ja mis tahes pikaajalise mälu/märkmete failid võivad mainida `OLD`-i
   nime või vana tee järgi:
   ```bash
   grep -rln "OLD" <lib> <memory-dirs> 2>/dev/null
   ```
   Asenda esmalt kõige spetsiifilisem string (täielik vana *tee* enne paljast *nime*), et oskus, mis
   samuti liikus, saaks oma tee puhtalt uuendatud.

## Samm 4 — Kontrolli

```bash
# broken symlinks in any hub
for hub in <hub-1> <hub-2>; do
  find -L "$hub" -maxdepth 1 -type l ! -exec test -e {} \; -print
done
# no lingering old names
grep -rn "OLD" <lib> 2>/dev/null
# each renamed skill's name: matches its dir
grep -m1 "^name:" <lib>/NEW/SKILL.md
```

Kinnita, et laadija registreerib iga ümbernimetatud oskuse uue nime all. Eemalda kõik eelnevalt surnud
symlink’id, mida pühkimisel leiad — odav parandada, segadust tekitav jätta.

## Märkused
- Ära kunagi kustuta oskust, mida sa ei ümber nimetanud. Puuduta ainult seda, mida konventsioon nõuab.
- Ümbernimetamised on odavad ja tagasipööratavad; katkised ristviited on tegelik kulu — sammude 3.4 ja 4
  on selle oskuse mõte, mitte `mv`.
- Commit’i repo-siseseid ümbernimetamisi üks loogiline ümbernimetamine commit’i kohta, et need bisect’iksid ja revert’iksid iseseisvalt.