omeka-s

Guide Omeka S theme, module, and configuration development across Docker and traditional deployments.

2|2|Updated Nov 6, 2025
One-click install
npx skills add https://github.com/szweibel/claude-skills --skill omeka-s
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: omeka-s
Source: https://github.com/szweibel/claude-skills/tree/main/omeka-s
Command: npx skills add https://github.com/szweibel/claude-skills --skill omeka-s

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Provides expert guidance for developing and troubleshooting Omeka S installations, including themes, modules, configuration, and deployment workflows across Docker and traditional servers.

Core Features & Use Cases

  • Theme development: CSS/SCSS tweaks, template overrides, asset management.
  • Module development: PHP modules, events, forms, database integration.
  • Configuration & troubleshooting: setup, permissions, and performance considerations.
  • Deployment guidance: Docker patterns and server setups for Omeka S.
  • Use Case: Rapidly configure a new Omeka S site with a custom theme and a module, then verify permissions and item visibility.

Quick Start

Set up a Docker-based Omeka S environment, create a theme override, and implement a simple module following the workflow guidance.

Frequently Asked Questions about omeka-s

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

FAQPage Schema
How do I develop a custom theme for Omeka S?

Theme development for Omeka S involves creating CSS/SCSS overrides, customizing templates, and managing assets. Start by duplicating the default theme, then modify template files and stylesheets to match your site design. The Skill guides template structure, asset inclusion, and layout customization across Docker and traditional deployments.

Can I build PHP modules for Omeka S?

Yes, Omeka S module development uses PHP with event-driven architecture. You write event handlers, forms, and database queries following Omeka's module structure. This Skill covers module scaffolding, event handling patterns, form construction, and database integration to extend site functionality.

What's the best way to deploy Omeka S with Docker?

Docker-based Omeka S deployment uses containerized environments for consistency across development, staging, and production. Key workflows include container file management, permission handling, and CLI operations. This Skill addresses Docker patterns, in-container workflows, and configuration best practices for reliable deployments.

How do I troubleshoot Omeka S permissions and item visibility issues?

Permission and visibility issues in Omeka S stem from file ownership, directory permissions, and database configuration. Troubleshooting involves checking container/server permissions, verifying database queries, and reviewing module and theme configurations. This Skill provides diagnostic patterns and resolution workflows for common configuration problems.

Can I customize Omeka S without modifying core files?

Yes, Omeka S customization follows an override pattern using themes and modules rather than core changes. CSS/SCSS tweaks, template overrides, and event-driven module additions preserve upgradability. This Skill explains the override hierarchy, safe customization boundaries, and integration patterns for sustainable development.

Do I need Docker to develop Omeka S themes and modules?

Docker is optional but recommended for consistency. Omeka S development works on traditional servers with PHP, but Docker provides isolated environments, simplified setup, and production parity. This Skill covers workflows for both approaches, including file management, debugging, and deployment transitions between environments.