Kirby Frontend Skill
kildahldev/kirby-frontend-skill
Especializa Claude em frontends Angular com Kirby Design System
Ver no GitHubSkill 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-skill1 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
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 Sassglobal-styles/utilsentry points, theangular.jsonicon-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 SCSSutilsfunctions, and the full list of 144 built-in icon names. - App shell —
kirby-app+kirby-router-outlet, and thekirby-tab-barrouting 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'simports: [...]. - 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-iconneeds the SVG assets copied inangular.jsonor 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.