# Kirby Panel And Blueprints

> Designs Kirby blueprints and Panel UI, including blueprint reuse/extends, programmable blueprints, and custom Panel fields/sections/areas. Use when changing the Panel experience or schema. Use when this capability is needed.

- Skill: `tomevault-io/kirby-panel-and-blueprints` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/kirby-panel-and-blueprints`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/kirby-panel-and-blueprints/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/kirby-panel-and-blueprints

---


# Kirby Panel and Blueprints

## KB entry points

- `kirby://kb/scenarios/06-blueprints-reuse-extends`
- `kirby://kb/scenarios/19-programmable-blueprints`
- `kirby://kb/scenarios/53-panel-first-custom-field`
- `kirby://kb/scenarios/54-panel-first-custom-section`
- `kirby://kb/panel/reference-fields`
- `kirby://kb/panel/panel-bundling-decisions`

## Required inputs

- Content model and required fields.
- Panel UX (tabs/sections/layout) and validation rules.
- Whether to extend an existing blueprint.

## Minimal blueprint skeleton

```yaml
title: Example
status:
  draft: true
  listed: true
fields:
  title:
    type: text
  text:
    type: textarea
```

## Extends example

```yaml
extends: pages/default
```

## Common pitfalls

- Duplicating fields instead of using `extends`.
- Implementing Panel UI logic in templates instead of blueprints or plugins.

## Workflow

1. Clarify the content model, required fields, and Panel UX expectations.
2. Call `kirby:kirby_init` and read `kirby://roots`.
3. Inspect existing blueprints and patterns:
   - `kirby:kirby_blueprints_index`
   - `kirby:kirby_blueprint_read`
4. Use Panel reference resources for field/section choices:
   - `kirby://fields`
   - `kirby://sections`
5. Check plugin surface when custom Panel UI is needed:
   - `kirby:kirby_plugins_index`
   - `kirby://extensions`
6. Search the KB with `kirby:kirby_search` (examples: "blueprints reuse extends", "programmable blueprints", "custom panel field", "custom panel section", "panel branding").
7. Implement minimal, convention-aligned YAML/PHP; prefer `extends` and shared sections over duplication.
8. Validate by re-reading the blueprint (`kirby:kirby_blueprint_read`) and verifying frontend output with `kirby:kirby_render_page` when relevant.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/bnomei) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->