Claude-skill-registry 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.

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/kirby-ide-support" ~/.claude/skills/majiayu000-claude-skill-registry-kirby-ide-support && rm -rf "$T"
manifest: skills/data/kirby-ide-support/SKILL.md
source content

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

/** @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").