Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

annotate

/annotate

Dodaje i porządkuje adnotacje Arkive: nazwy, grupy, tagi, pomijanie komponentów i identyfikatory projektu Figma w katalogu pokazowym.

Repozytorium
arkive ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
23.09.2026

Ocena i bezpieczeństwo

90/ 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ść25 / 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
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 23.09.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 robi i kiedy

Dodaje i porządkuje adnotacje Arkive: nazwy, grupy, tagi, pomijanie komponentów i identyfikatory projektu Figma w katalogu pokazowym.

Oryginalny opis (EN)

Use when adding, editing, or reviewing Arkive annotations — @ArkiveComposable, @ArkiveView, or curating what @Preview components show in the catalogue: names, groups, tags, skip, Figma designNodeId. Triggers every time a component or screen is added to the Arkive showcase or its catalogue metadata changes. Enforces the shared naming/grouping conventions so the sidebar tree stays consistent.

Jak działa

  1. Procedure
  2. Red flags
Sekcje z nagłówków SKILL.md, w oryginale · 38 linii, 318 słów
Podgląd SKILL.md
---
name: annotate
description: 'Use when adding, editing, or reviewing Arkive annotations — @ArkiveComposable, @ArkiveView, or curating what @Preview components show in the catalogue: names, groups, tags, skip, Figma designNodeId. Triggers every time a component or screen is added to the Arkive showcase or its catalogue metadata changes. Enforces the shared naming/grouping conventions so the sidebar tree stays consistent.'
---

# Arkive Annotate

Add or edit Arkive catalogue annotations following the project's conventions. The full
standard lives in `references/annotation-conventions.md` — read it
before writing any annotation.

## Procedure

1. **Inventory first.** List the groups and tags that already exist (grep for `group =` /
   `tags =` in the module's annotations, or read the latest `arkive-showcase.json`).
   Reuse exact spelling, casing, and pluralization. Only invent a new group when nothing
   existing fits — and say so.
2. **Prefer `@ArkiveComposable` when adding a component to the catalogue.** A non-private
   `@Preview` is collected by default, but `@ArkiveComposable` carries richer info
   (`tags`, `designNodeId`, `skip`) and is validated with build errors instead of silent
   skips — it's the standard for anything that stays in the catalogue. Don't
   mass-annotate a codebase unprompted, but when the task is "add/curate this component",
   annotate it properly rather than leaving a bare `@Preview`.
3. **Check visibility.** The processor drops `private` functions — raise annotated
   previews to `internal` if needed.
4. **Figma linking:** `designNodeId` takes the `X-Y` node id from the component's Figma
   URL, and needs `arkive { designFileKey }` set once per module. If the user gives a
   Figma URL, extract both.
5. **Verify** when a recording already exists: after annotating, `generateShowcase<Variant>`
   and confirm the component appears under the intended group with the intended name.

## Red flags

- A preview that renders more than one instance of the component — a `Row`/`Column` of
  sizes, styles, or an enabled/disabled pair. One preview = one instance; variation goes
  through a `@PreviewParameter` provider (one value per catalogue variant).
- Inventing a group without listing the existing ones first.
- `"Buttons"` / `"Button"` / `"buttons"` coexisting — casing/pluralization drift.
- Encoding variant info (font, density, RTL) in tags — the variant system owns that.
- Deleting or privatizing a preview to hide it — that's what `skip = true` is for.
- Overriding the project's own established conventions with this document's defaults.
Pliki w paczce (2)
  • SKILL.md 3 KB
  • references 1 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · infinum/arkive90Apache-2.0
glebis/claude-skills100MIT
janburzinski/annotate100MIT
Wahajolla/annotator-skill100MIT
mmurakaru/cueloop100Apache-2.0
a8cteam51/claude-code-plugins100MIT

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

  • 90find
    Sprawdza, czy w katalogu Arkive i w kodzie istnieje już ekran lub komponent z projektu Figma, i zwraca decyzję: użyć, rozbudować lub zbudować.
  • 100setup
    Dodaje bibliotekę Arkive do projektu: instaluje wersję z Maven Central, konfiguruje moduły z podglądami i generuje pokaz.
  • 100component-naming
    Wymusza spójne nazewnictwo komponentów React w kodzie portfolio przy tworzeniu, przeglądzie i refaktoryzacji komponentów.
  • 90figma-design-to-code
    Prowadzi implementację projektu z Figmy jako kodu: odczytuje węzeł przez get_design_context i dopasowuje wynik referencyjny do docelowego projektu, z ponownym użyciem istniejących komponentów.
  • 95annotate-project
    Analizuje kod projektu i tworzy adnotacje do funkcji i fragmentów w bazie simply-annotate, a ogólny opis trafia do pliku .org.
  • 100figma-design-react
    Analizuje projekt Figma i proponuje architekturę komponentów React: API właściwości i obsługę wariantów, bez budowania samych komponentów.

Uwagi i zgłoszenia

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