php-doc

Generate standardized PHPDoc annotations for PHP classes, methods, and properties.

41|4|Updated Jan 4, 2026
One-click install
npx skills add https://github.com/nette/claude-code --skill php-doc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: php-doc
Source: https://github.com/nette/claude-code/tree/main/plugins/nette-dev/skills/php-doc
Command: npx skills add https://github.com/nette/claude-code --skill php-doc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the tedious manual work of writing consistent PHPDoc comments, helping developers produce clear, actionable documentation.

Core Features & Use Cases

  • Structured Documentation: Generate class, method, and property PHPDoc blocks with standardized tags.
  • Consistency & Quality: Enforce active voice, concise wording, and uniform parameter/return descriptions across the codebase.
  • Use Case: When onboarding new developers or performing a large refactor, generate comprehensive PHPDoc for existing code to improve understanding and reduce onboarding time.

Quick Start

Ask the AI to generate a PHPDoc block for a given class or method, then provide the target signature and any contextual notes.

Frequently Asked Questions about php-doc

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate PHPDoc annotations for complex method signatures?

You can generate PHPDoc annotations by providing the target method signature and contextual notes to the AI. It produces standardized @param and @return descriptions, handling nullable types and array contents across diverse PHP patterns.

What is the best way to write consistent PHPDoc blocks for an existing codebase?

The best way to write consistent PHPDoc blocks is to enforce active voice and concise phrasing across all classes, methods, and properties. This ensures uniform parameter and return descriptions, improving overall code readability and tooling.

Can I document nullable types and array contents in PHP code comments automatically?

Yes, you can document nullable types and array contents automatically. The generation process includes special handling for these specific type hints to ensure the resulting PHPDoc annotations accurately reflect complex variable structures.

Does automated PHPDoc generation work for large refactoring and developer onboarding?

Automated PHPDoc generation works for large refactoring and developer onboarding by applying structured documentation to existing code. This reduces onboarding time and improves codebase understanding during maintenance across diverse architectural patterns.

Why does my PHP documentation lack consistent @param and @return descriptions?

Your PHP documentation lacks consistency because manual annotation often fails to enforce active voice and standardized tags. Generating PHPDoc blocks programmatically enforces uniform parameter and return descriptions, eliminating tedious manual work.