annotate
/annotate
Dodaje i porządkuje adnotacje Arkive: nazwy, grupy, tagi, pomijanie komponentów i identyfikatory projektu Figma w katalogu pokazowym.
Ocena i bezpieczeństwo
- Pliki w paczce
- 2
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 23.09.2026, bez odwołań do wycofanych modeli i API.
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
- Procedure
- Red flags
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
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · infinum/arkive | 90 | Apache-2.0 |
| glebis/claude-skills | 100 | MIT |
| janburzinski/annotate | 100 | MIT |
| Wahajolla/annotator-skill | 100 | MIT |
| mmurakaru/cueloop | 100 | Apache-2.0 |
| a8cteam51/claude-code-plugins | 100 | MIT |
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.