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

html-semantic-recipes

/html-semantic-recipes

Dostarcza semantyczne wzorce HTML5 dla komponentów interfejsu, takich jak nawigacja, formularze i akordeony, w wersjach dla różnych frameworków.

Licencja
MIT
Ostatnia zmiana repozytorium
27.10.2026

Ocena i bezpieczeństwo

85/ 100Klasa: dobry
Format20 / 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
6
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

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

Dostarcza semantyczne wzorce HTML5 dla komponentów interfejsu, takich jak nawigacja, formularze i akordeony, w wersjach dla różnych frameworków.

Oryginalny opis (EN)

Provides semantic HTML5 markup patterns for common UI components (breadcrumbs, cards, navigation, forms, login, accordion, definition lists, checkbox groups) adapted for HTML, React, Vue, Angular, Svelte, and Astro. Use when writing or generating UI markup, building accessible components, creating forms with validation, or when the user asks for semantic HTML, accessible markup, or framework-agnostic component skeletons.

Jak działa

  1. When to Use This Skill
  2. Core Principles
  3. Framework Adaptation Rules
  4. Recipe Index
  5. How to Apply a Recipe
  6. Quick Reference: Semantic Element Choices
  7. Full Markup
Sekcje z nagłówków SKILL.md, w oryginale · 72 linii, 762 słów
Podgląd SKILL.md
---
name: html-semantic-recipes
description: Provides semantic HTML5 markup patterns for common UI components (breadcrumbs, cards, navigation, forms, login, accordion, definition lists, checkbox groups) adapted for HTML, React, Vue, Angular, Svelte, and Astro. Use when writing or generating UI markup, building accessible components, creating forms with validation, or when the user asks for semantic HTML, accessible markup, or framework-agnostic component skeletons.
---

# HTML Semantic Recipes

Semantic HTML markup recipes for common UI components, adapted per framework. Prefer semantic elements over `div` soup, include accessibility attributes, and match the target framework's syntax.

## When to Use This Skill

- Building UI components: cards, navigation, breadcrumbs, accordions, key-value lists
- Creating forms: basic contact forms, login forms, inline validation, error summaries
- User asks for "semantic HTML", "accessible markup", or "clean HTML structure"
- Generating component skeletons in HTML, React (JSX/TSX), Vue, Angular, Svelte, or Astro

## Core Principles

1. **Semantic elements first** — `article`, `header`, `footer`, `nav`, `section`, `fieldset`, `legend`, `dl`/`dt`/`dd`, `details`/`summary` instead of `div`/`span`
2. **Accessibility built in** — every input gets a `<label for>`; validation messages use `aria-live`; error summaries use `role="alert"`; use `aria-describedby` to link inputs to errors
3. **Minimal styling hooks** — only add `class` where a visual grouping is truly needed (e.g., accordion wrapper); let consumers style with their own CSS
4. **Framework adaptation** — adapt attribute syntax and directives to the target framework (see table below)

## Framework Adaptation Rules

| Concern            | HTML            | React                  | Vue                        | Angular                          | Svelte                          | Astro                 |
| ------------------ | --------------- | ---------------------- | -------------------------- | -------------------------------- | ------------------------------- | --------------------- |
| Class attribute    | `class`         | `className`            | `class`                    | `class`                          | `class`                         | `class`               |
| Label attribute    | `for`           | `htmlFor`              | `for`                      | `for`                            | `for`                           | `for`                 |
| Autocomplete       | `autocomplete`  | `autoComplete`         | `autocomplete`             | `autocomplete`                   | `autocomplete`                  | `autocomplete`        |
| Input binding      | —               | state/props            | `v-model`                  | `[(ngModel)]`                    | `bind:value`                    | —                     |
| Checkbox group     | `name`          | state                  | `v-model` + `value`        | `[(ngModel)]` + `name`           | `bind:group` + `value`          | `name` + `value`      |
| Form submit        | `action`/`method` | `onSubmit` handler   | `@submit.prevent`          | `(ngSubmit)` + `#ref="ngForm"`   | `on:submit\|preventDefault`     | comment: add handler  |
| List rendering     | static markup   | `.map()`               | `v-for` + `:key`           | `*ngFor` + `trackBy`             | `{#each}`                       | `{items.map()}`       |
| Conditional render | static/hidden   | `{cond && ...}`        | `v-if`                     | `*ngIf`                          | `{#if}`                         | JS in code fence      |
| Internal links     | `<a href>`      | `<a href>` / `<Link>`  | `<router-link to>`         | `<a [routerLink]>`               | `<a href>` / `<Link>`           | `<a href>`            |
| Disabled state     | `disabled`      | `disabled`             | `:disabled`                | `[disabled]`                     | `disabled={...}`                | `disabled`            |

## Recipe Index

| Recipe                | Use for                                              | Reference file                        |
| --------------------- | ---------------------------------------------------- | ------------------------------------- |
| `breadcrumbs`         | Hierarchical path navigation                         | `references/recipes.md#breadcrumbs`   |
| `nav`                 | Primary site/menu navigation                         | `references/recipes.md#navigation`   |
| `card`                | Single content card (header/body/footer)             | `references/recipes.md#card`          |
| `cardlist`            | Ordered collection of cards                          | `references/recipes.md#card-list`     |
| `datalist`            | Key-value detail display (`dl`/`dt`/`dd`)            | `references/recipes.md#data-list`     |
| `checkboxlist`        | Grouped checkbox options (`fieldset`/`legend`)       | `references/recipes.md#checkbox-list` |
| `formbasic`           | Standard contact/form fields                         | `references/recipes.md#form-basic`    |
| `formvalidation`      | Form with inline per-field error messages            | `references/recipes.md#form-inline`   |
| `formvalidationsummary` | Form with error summary + per-field errors         | `references/recipes.md#form-summary`  |
| `login`               | Username/password auth form                          | `references/recipes.md#login-form`    |
| `accordion`           | Expandable sections (`details`/`summary`)            | `references/recipes.md#accordion`     |

## How to Apply a Recipe

1. **Identify the component** the user needs (card, form, nav, etc.) and the **target framework** from the project context (check file extensions, imports, `package.json`).
2. **Read the matching recipe** in `references/recipes.md` — each recipe has an HTML base plus per-framework variants.
3. **Substitute placeholders** with real content: replace generic titles, hrefs, field names, and copy with the user's actual domain values.
4. **Keep accessibility wiring intact** — never drop `label`/`for` pairs, `aria-live` on validation messages, or `role="alert"` on error summaries.
5. **Match project conventions** — if the codebase uses a router component (`Link`, `router-link`), component libraries, or CSS modules, adapt the link/binding syntax accordingly while preserving the semantic structure.

## Quick Reference: Semantic Element Choices

- **Card** → `article` with `header`, content, `footer` (not `div.card`)
- **Breadcrumbs** → `nav` containing a `p` of links (not `ol` of `div`s)
- **Key-value data** → `dl`/`dt`/`dd` (not tables or definition divs)
- **Checkbox groups** → `fieldset` + `legend` (not bare divs of checkboxes)
- **Accordion** → `details`/`summary` (native, keyboard accessible — no JS required)
- **Validation summary** → `section[role=alert]` with anchor links to each invalid field
- **Form fields** → every control wrapped in `p` with a real `label[for]` — never placeholder-only labels

## Full Markup

The complete, copy-paste-ready markup for every recipe and framework is in `references/recipes.md`. Load that file when you need the exact patterns; use this SKILL.md for routing and rules.
Pliki w paczce (6)
  • .gitignore 1 KB
  • LICENSE 1 KB
  • README.md 6 KB
  • SKILL.md 7 KB
  • package.json 1 KB
  • references/recipes.md 26 KB

Wersje

W bazie nie ma innych skilli o nazwie html-semantic-recipes.

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

  • 90fe-html
    Pisze i przegląda poprawny semantycznie kod HTML i szablony, z nagłówkami, punktami orientacyjnymi i przyciskami dostępnymi dla każdego.
  • 100accordion-accessibility
    Sprawdza, czy akordeony są nawigowalne klawiaturą, w wyrenderowanym HTML i komponentach, weryfikując kod widoczny w przeglądarce.
  • 100accessible-tables
    Sprawdza semantyczne znaczniki tabel pod kątem czytników ekranu, kolejności fokusu i nazw dostępnych w wyrenderowanym HTML i komponentach interaktywnych.
  • 100html-syntax-and-semantics
    Podaje zasady poprawnego, semantycznego i dostępnego HTML: strukturę dokumentu, wybór elementów, formularze, obrazy, linki i tabele.
  • 100ensuring-accessibility
    Wdraża wzorce WCAG 2.1 AA w komponentach frontendu: semantyczny HTML, nawigacja klawiaturą, zarządzanie fokusem, ARIA tylko tam, gdzie potrzeba, kontrast i weryfikacja axe-core.
  • 95playwright-frontend
    Pomaga pisać komponenty, które testy i agenci znajdą pewnie: semantyczny markup, priorytety lokatorów i stabilne atrybuty data-testid.

Uwagi i zgłoszenia

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