# Kirby Ide Support

> Improves IDE autocomplete and static analysis in Kirby projects with PHPDoc hints and Kirby IDE helper generation. Use when types are missing or IDE support is degraded.

- Skill: `majiayu000/kirby-ide-support` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/kirby-ide-support`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/kirby-ide-support/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/kirby-ide-support

---


# Kirby IDE Support

## Quick start

- Follow the workflow below for a minimal, types-only IDE pass.

## KB entry points

- `kirby://kb/scenarios/18-ide-support`
- `kirby://kb/glossary/page-model`
- `kirby://kb/glossary/template`

## Required inputs

- Target files and scope (templates/snippets/controllers/models).
- Whether to generate helpers or only add PHPDoc hints.

## Minimal PHPDoc hints

```php
/** @var Kirby\Cms\Site $site */
/** @var Kirby\Cms\Page $page */
```

- Place hints at the top of templates/snippets; keep them types-only.

## Generation rule

- Add PHPDoc hints for a few files or local fixes.
- Generate IDE helpers when multiple templates/models lack types or for project-wide refresh.

## Common pitfalls

- Generating helpers for a single missing type.
- Leaving stale helpers after blueprint or model changes.

## Workflow

1. Call `kirby:kirby_init`, then check status with `kirby:kirby_ide_helpers_status`.
2. Inspect templates/snippets/controllers/models for missing hints:
   - `kirby:kirby_templates_index`
   - `kirby:kirby_snippets_index`
   - `kirby:kirby_controllers_index`
   - `kirby:kirby_models_index`
3. Add minimal, types-only improvements:
   - `@var` hints in templates/snippets
   - typed controller closures
   - ensure page models extend the correct base class
4. If generating helpers, run `kirby:kirby_generate_ide_helpers(dryRun=true)` first; ask before writing, then run with `dryRun=false`.
5. Re-run `kirby:kirby_ide_helpers_status` and summarize changes.
6. Search the KB with `kirby:kirby_search` (example: "ide support").