convez.ai
SkillDesenvolvimento WebIntermediário
kildahldev

Kirby Frontend Skill

kildahldev/kirby-frontend-skill

Especializa Claude em frontends Angular com Kirby Design System

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill para Claude Code que especializa a IA na construção de frontends Angular com o Kirby Design System. Fornece catálogo de ~40 componentes, padrões de overlay, design tokens e gotchas específicas do Kirby, eliminando alucinações sobre APIs e imports.

Instalação

$npx convez-ai kildahldev/kirby-frontend-skill

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Gerar componentes Angular standalone com Kirby rapidamente
  • Implementar modais, drawers e overlays com controllers Kirby
  • Aplicar design tokens e temas Kirby corretamente
  • Evitar erros comuns de import e seletores do Kirby

Veredito

Skill maduro e prático que resolve um problema real: Claude alucina sobre APIs do Kirby. A documentação é exaustiva, baseada em source code real (v11.8.0), e inclui starters prontos. Essencial para equipes usando Kirby + Angular + Claude Code em produção.

README

A tradução para o português deste README ainda está na fila.

kirby-frontend — a Claude Code skill

A Claude Code skill for building Angular frontends with the Kirby Design System (@kirbydesign/designsystem). It gives Claude the accurate, current procedural knowledge it otherwise half-remembers: the standalone secondary-entry-point import model, every component's real selector and API, the service-driven overlays, and the design tokens.

Built against Kirby v11.8.0 (Angular 18–21, Ionic 8), extracted June 2026. Every API in the skill was extracted from the upstream source, not guessed — and the skill teaches Claude to verify any API against the installed package's .d.ts files when versions drift, so it degrades gracefully instead of confidently applying stale knowledge.

What it covers

  • Setup — provideKirby(withGlobalSetup()), the Sass global-styles/utils entry points, the angular.json icon-asset copy, testing modules, micro-frontends, and the errors you hit when one is missing.
  • Components — a catalog of ~40 components (page, card, list/item, header, forms, buttons, status/feedback, navigation, charts) with entry point, selector, inputs/outputs, slots, and a real markup snippet each.
  • Overlays — modals, drawers, alerts, action sheets, toasts, popovers, and loading overlays via ModalController / ToastController / LoadingOverlayService, including passing data in (COMPONENT_PROPS) and closing from inside (Modal.close).
  • Design tokens — theme colors (including which components accept only a subset of the palette), kirby-text-* typography, the spacing scale, the .kirby-grid, the SCSS utils functions, and the full list of 144 built-in icon names.
  • App shell — kirby-app + kirby-router-outlet, and the kirby-tab-bar routing wiring.
  • Ready-to-adapt standalone starters in assets/: a complete feature page and a complete modal content component.

The gotchas it gets right

These trip up generic Angular/HTML instincts — the skill bakes them in:

  • Import each component from its own secondary entry point (@kirbydesign/designsystem/button), not a barrel; add it to a standalone component's imports: [...].
  • A button is an attribute on a native element: <button kirby-button>, not <kirby-button>. Same for <input kirby-input> inside <kirby-form-field>.
  • Overlays are opened from TypeScript via injected controllers, never toggled with *ngIf.
  • kirby-icon needs the SVG assets copied in angular.json or it silently 404s.
  • A screen is wrapped in <kirby-page> with *kirbyPageContent.

Install

Clone (or copy) into your Claude Code skills directory so it's auto-discovered:

git clone https://github.com/kildahldev/kirby-frontend-skill.git \
  ~/.claude/skills/kirby-frontend

Or add it to a project at .claude/skills/kirby-frontend/. Claude loads the skill's name + description always, and the rest on demand, so it triggers whenever you work with Kirby in an Angular context.

Structure

kirby-frontend/
├── SKILL.md                        # mental model, golden rules, component map, workflow,
│                                   # version guard + how to verify APIs against node_modules
├── references/
│   ├── setup.md
│   ├── components.md
│   ├── overlays.md
│   └── design-tokens.md
└── assets/
    ├── feature-page.component.ts   # complete standalone starter page
    └── detail-modal.component.ts   # complete standalone modal content component

Credits & license

The component APIs, selectors, and idioms documented here are derived from the kirbydesign/designsystem project (MIT licensed) and its cookbook. Kirby is a trademark/project of its respective owners; this is an unofficial, community helper skill.

This skill is released under the MIT License.

Ver o original no GitHub

Bom para

Relacionados