hebrew-dates-dev
Project-specific skill for developing the Hebrew Dates WordPress Admin dashboard widget. Guides implementation, tracks development process, documents challenges/learnings, and ensures project requirements are met.
When & Why to Use This Skill
The Hebrew Dates Dev skill is a specialized project management and coding assistant designed to streamline the development of WordPress Admin dashboard widgets. It provides a structured, phase-based workflow that covers everything from initial file architecture and Hebrew calendar logic to security auditing and automated documentation. By enforcing WordPress coding standards and security best practices, it helps developers build robust, localized plugins while maintaining a detailed process journal for better project tracking and transparency.
Use Cases
- Developing a custom WordPress Admin widget that accurately converts and displays Hebrew dates using PHP.
- Ensuring WordPress plugin security compliance by performing automated checks for direct file access and proper output escaping.
- Managing the end-to-end software development lifecycle (SDLC) for niche WordPress projects with integrated process journaling.
- Generating professional, repository-ready README documentation that details development challenges, AI tool usage, and technical requirements.
| name | hebrew-dates-dev |
|---|---|
| description | "Project-specific skill for developing the Hebrew Dates WordPress Admin dashboard widget. Guides implementation, tracks development process, documents challenges/learnings, and ensures project requirements are met." |
| compatibility | "WordPress 6.x+, PHP 7.4+" |
Hebrew Dates Plugin Development Skill
Purpose
This skill guides the development of a WordPress Admin dashboard widget that displays the current Hebrew date. It ensures:
- Plugin meets all technical requirements
- Development process is documented for the required README
- Security best practices are followed
- Challenges and learnings are tracked
Project Requirements Summary
Plugin Must:
- Activate without errors
- Display Hebrew date in a dashboard widget
- Include basic security hygiene
Repository Must Include:
- Plugin files (functional code)
- README.md with:
- Why Hebrew dates were chosen
- AI tools/models used
- Development process description
- Struggles encountered and solutions
When to Use This Skill
Invoke this skill (/hebrew-dates-dev) when:
- Starting or resuming plugin development
- Needing guidance on next development steps
- Documenting a challenge or learning
- Preparing to write/update the README
- Reviewing code for security or best practices
- Verifying the plugin meets requirements
Procedure
Phase 1: Project Setup
Create plugin file structure:
hebrew-dates-wp-admin/ ├── hebrew-dates-admin.php # Main plugin file ├── includes/ │ └── class-hebrew-date.php # Hebrew date calculation ├── README.md # Required documentation └── .claude/ └── process-journal.md # Development log (private)Initialize process journal:
- Create
.claude/process-journal.mdto track development - Log each significant step, challenge, and decision
- Create
Phase 2: Core Implementation
Main plugin file (
hebrew-dates-admin.php):- Plugin header with proper metadata
- Security: Direct access prevention
- Hook into
wp_dashboard_setupaction - Register the dashboard widget
Hebrew date calculation (
includes/class-hebrew-date.php):- Convert current Gregorian date to Hebrew date
- Format Hebrew date with Hebrew month names
- Handle edge cases (sunset transitions if desired)
Dashboard widget display:
- Clean, readable output
- Proper escaping of all output
- Minimal styling (optional inline CSS)
Phase 3: Security Hygiene
Before considering complete, verify:
- Direct file access is blocked (
defined('ABSPATH')check) - All output is properly escaped (
esc_html(),esc_attr()) - No user input is processed (reduces attack surface)
- Plugin follows WordPress coding standards
See: references/security-checklist.md
Phase 4: Testing
Activation test:
# In wp-env or local WordPress wp plugin activate hebrew-dates-admin wp plugin list | grep hebrewVisual verification:
- Log into WordPress Admin
- Navigate to Dashboard
- Confirm widget displays with correct Hebrew date
Error check:
wp eval "error_reporting(E_ALL); require_once('wp-content/plugins/hebrew-dates-admin/hebrew-dates-admin.php');"
Phase 5: Documentation
- Update README.md using the template in
references/readme-template.md - Review process journal for key struggles and learnings
- Document AI usage (Claude Code with Opus 4.5)
Verification Checklist
Before submission:
- Plugin activates without PHP errors/warnings
- Dashboard widget appears on Admin Dashboard
- Hebrew date displays correctly
- All PHP files have ABSPATH check
- All output uses WordPress escaping functions
- README.md contains all required sections
- Process/challenges are documented
Process Journal Management
Track development in .claude/process-journal.md:
## YYYY-MM-DD: [Topic]
### What I did
[Description of work]
### What worked
[Successful approaches]
### What didn't work
[Failed approaches and why]
### What I learned
[Key insights]
### AI assistance
[How Claude Code helped]
Common Issues
Widget not appearing
- Check hook is
wp_dashboard_setup, notadmin_init - Verify callback function exists and is callable
- Confirm plugin is activated
Incorrect Hebrew date
- Verify timezone handling
- Check date calculation logic
- Consider sunset transitions (Orthodox calendars switch at sunset)
Activation errors
- Check for syntax errors:
php -l hebrew-dates-admin.php - Verify all included files exist
- Check for PHP version incompatibilities
References
references/development-workflow.md- Step-by-step implementation guidereferences/process-journal.md- Journal template and examplesreferences/security-checklist.md- Security verification checklistreferences/readme-template.md- README.md template for submission
Escalation
For Hebrew calendar calculations, reference:
- PHP
cal_from_jd()withCAL_JEWISHconstant - The jewish calendar functions in PHP's calendar extension
For WordPress dashboard widgets, reference:
wp_add_dashboard_widget()function- WordPress Dashboard Widgets API documentation