Przejdź do treści
Biblioteka skilli
Projektowanie i UX · Automatyzacja

sync-ui-kit

/sync-ui-kit

Odbudowuje manifest komponentów z metadanych UI kitu ONLYOFFICE, gdy kit się zmienia lub wydaje nową wersję.

Repozytorium
agent-skills ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
29.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
1
Adresy URL w SKILL.md
2
Przestarzałość

Brak sygnałów. Repozytorium zmienione 29.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co sprawdzić przed instalacją
  • SKILL.md zawiera komentarze HTML (1). Nie widać ich w podglądzie Markdown, a model je czyta.

Co robi i kiedy

Odbudowuje manifest komponentów z metadanych UI kitu ONLYOFFICE, gdy kit się zmienia lub wydaje nową wersję.

Wyzwalacze z opisu

s component manifest from the ONLYOFFICE UI kitregenerate the kit manifestupdate check-usage
Oryginalny opis (EN)

Rebuild the apps-ui-kit skill's component manifest from the ONLYOFFICE UI kit's own metadata. Use when docspace-ui-kit-react has changed and skills/apps-ui-kit/scripts/data/kit-manifest.json must follow, when the kit releases a new version, when someone asks to "regenerate the kit manifest" or "update check-usage's view of the kit", and when `node tools/sync-ui-kit.mjs --from <kit> --check` fails in the release checklist. Repository-internal; not shipped in the plugin.

Jak działa

  1. Rules
  2. Commands
  3. After the kit changes
  4. When --check fails
Sekcje z nagłówków SKILL.md, w oryginale · 61 linii, 487 słów
Podgląd SKILL.md
---
name: sync-ui-kit
description: >
  Rebuild the apps-ui-kit skill's component manifest from the ONLYOFFICE UI kit's own metadata.
  Use when docspace-ui-kit-react has changed and skills/apps-ui-kit/scripts/data/kit-manifest.json
  must follow, when the kit releases a new version, when someone asks to "regenerate the kit
  manifest" or "update check-usage's view of the kit", and when
  `node tools/sync-ui-kit.mjs --from <kit> --check` fails in the release checklist.
  Repository-internal; not shipped in the plugin.
---

# Rebuild the apps-ui-kit manifest from the kit

`skills/apps-ui-kit/scripts/data/kit-manifest.json` is not written here. It is derived by
`tools/sync-ui-kit.mjs` from [`docspace-ui-kit-react`](https://github.com/ONLYOFFICE/docspace-ui-kit-react):
the `<!-- ui-kit-doc … -->` block of every component README (name, category, status, import
form, the prop that shows and hides the component), the portal-internal modules of
`docs/public-api.md`, and the root-barrel snapshot in `docs/plugin-surface.json`. It is the
data `check-usage.mjs` validates a project against.

The skill carries no copies of the kit's pages. An agent reads a component's README inside
the installed package, or its page on the docs site (`https://api.onlyoffice.com/docspace/ui-kit/`);
`SKILL.md` says in which order.

## Rules

- **Never edit the manifest by hand.** A wrong entry is a wrong metadata block in the kit: fix
  the component's README in `docspace-ui-kit-react`, then rebuild.
- **A README without a metadata block is absent from the manifest** and announced as
  `META-MISSING`; `--strict` turns that into a failure.
- The version the skill targets stays in `skills/apps-ui-kit/sources.json` and is written into the
  text by `sync-sources.mjs`; this tool only reports when the kit's version has moved past it.
- Links to the kit's documentation in the skill point at the docs site and are checked by
  `node tools/sync-sources.mjs --skill apps-ui-kit --check`; nothing here rewrites them.

## Commands

```
node tools/sync-ui-kit.mjs --from ../docspace-ui-kit-react --write   # rebuild the manifest
node tools/sync-ui-kit.mjs --from ../docspace-ui-kit-react --check   # exit 1 when it is out of date
node tools/sync-ui-kit.mjs --from ../docspace-ui-kit-react --dump    # print the derived manifest
```

`--from` takes a checkout of the kit or an installed `node_modules/@onlyoffice/apps-ui-kit`:
the package ships the component READMEs and the docs pages at their source paths, so both
trees read the same.

## After the kit changes

1. Pull the kit checkout to the revision the skill should describe.
2. `--from <kit> --write`, then read the run: the README count, the components in the manifest,
   and any `META-MISSING`.
3. If the kit's version moved, run the command the tool prints
   (`node tools/sync-sources.mjs --skill apps-ui-kit --set-version <x.y.z>`).
4. Re-read the critical rules in `skills/apps-ui-kit/SKILL.md` against the kit's pages. A rule the
   kit's page now states in the same words is a candidate for deletion — delete it only when
   its eval assertion still passes without it.
5. `node skills/apps-ui-kit/scripts/test-validator.mjs` and `node tools/sync-sources.mjs --check`.

## When --check fails

- `DRIFT` — the manifest differs from what the kit now says. Run `--write` and read the diff:
  a new visibility prop, a component that changed status or import form, a new barrel leak.
- `META-MISSING` — a README has no `ui-kit-doc` block. Fix it upstream against the kit's
  `README_TEMPLATE.md`.
- `META-BAD` — the block is not JSON. Fix it upstream.
- `TREE` — a top-level module the tool lists as public is missing from the kit. Either the kit
  renamed it, or the list in the tool is stale.
- `NO-SURFACE` — the kit ships no `docs/plugin-surface.json`; the barrel leak was read from
  `uploader` and `billing` by pattern instead, which is less complete.

Wersje

W bazie nie ma innych skilli o nazwie sync-ui-kit.

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

  • 90apps-ui-kit
    Buduje ekrany React 19 z zestawem ONLYOFFICE UI kit: formularze, okna, listy, powiadomienia, motywy i tłumaczenia.
  • 86create-design-system
    Tworzy system projektowy lub UI kit na prośbę użytkownika.
  • 100apps-plugin-sdk
    Buduje, sprawdza i opisuje wtyczki ONLYOFFICE Apps powstałe przez Plugins SDK, np. pozycje menu, strony w panelu i obsługę zdarzeń.
  • 100update-kit
    Aktualizuje pliki zestawu do najnowszej wersji, nie ruszając plików twórcy, i pokazuje, co się zmieniło.
  • 92create-design-system
    Tworzy system projektowy lub zestaw komponentów interfejsu, gdy użytkownik o to poprosi.
  • 100sync
    Doprowadza istniejące repozytorium do aktualnych szablonów zestawu, zachowując celowe zmiany projektu, przez zgłoszenia i pull requesty.

Uwagi i zgłoszenia

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