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.
pinned to #3474420updated 3 weeks ago
Ask your AI client: “install skills/kirby-ide-support”.
Requires the metahub MCP server installed in your client. Set up MCP.
mh install skills/kirby-ide-supportmetahub onboarded this repo on the author's behalf.
If you own github.com/bnomei/kirby-mcp on GitHub, claim the listing to take over publishing. Your claim preserves the existing eval history and badges; only the curator label is replaced with verified-publisher on your next publish.
Stars
56
Last commit
3 weeks ago
Latest release
published
- #agent-tools
- #agentic-workflow
- #claude-code
- #cli
- #codex-cli
- #commands
- #developer-tools
- #google-gemini
- #kirby
- #kirby-cms
- #knowledge-base
- #mcp-server
- #model-context-protocol
- #php8
- #prompts
- #resources
- #tools
Evaluation report
WarningsAutomated checks the publisher passed at publish time — structure, docs, safety, and whether the artifact behaves as claimed.3474420· 3 weeks ago
Kind-specific
31Skill: SKILL.md present
found at skills/kirby-ide-support/SKILL.md · frontmatter source: SKILL.md
Skill: body content present
197 words · 1,580 chars · 7 sections · 1 code block
Skill: triggers declaredwarn
No `trigger` phrases in SKILL.md frontmatter
Add `trigger:` lines so Claude knows when to activate this skill — e.g. `when building MCP servers` or `for diagram creation`.
Skill: allowed-tools scope
no allowed-tools restriction (Claude may use anything)
Release history
1- releasecurrent3474420warn3 weeks ago
Contents
Quick start
- Follow the workflow below for a minimal, types-only IDE pass.
KB entry points
kirby://kb/scenarios/18-ide-supportkirby://kb/glossary/page-modelkirby://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
- Call
kirby:kirby_init, then check status withkirby:kirby_ide_helpers_status. - Inspect templates/snippets/controllers/models for missing hints:
kirby:kirby_templates_indexkirby:kirby_snippets_indexkirby:kirby_controllers_indexkirby:kirby_models_index
- Add minimal, types-only improvements:
@varhints in templates/snippets- typed controller closures
- ensure page models extend the correct base class
- If generating helpers, run
kirby:kirby_generate_ide_helpers(dryRun=true)first; ask before writing, then run withdryRun=false. - Re-run
kirby:kirby_ide_helpers_statusand summarize changes. - Search the KB with
kirby:kirby_search(example: "ide support").
Reviews
No reviews yet. Be the first.
Related
orchestration-patterns
>
migration-patterns
>
deployment-sop
>
mh install skills/kirby-ide-support