OJS Expert Skill para Claude
global-prog/ojs-claude-skill
Especialista completo em OJS 3.4/3.5 para desenvolvimento e administração
Ver no GitHubSkill especializada que transforma Claude em um especialista em OJS (Open Journal Systems), cobrindo desenvolvimento de plugins e temas, integração com REST API, administração de sistemas e configuração de fluxos editoriais. Inclui catálogo de hooks verificados, constantes de sistema, procedimentos de upgrade e cliente Python para a API.
Instalação
npx convez-ai global-prog/ojs-claude-skill1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Desenvolvimento de plugins OJS com todas as 10 categorias e hooks verificados
- Criação e customização de temas com ThemePlugin API e variáveis LESS
- Integração com REST API (118 endpoints) e autenticação JWT
- Administração de instalações OJS: config.inc.php, upgrade, segurança
- Configuração de fluxos editoriais: estágios, decisões, revisão, DOI/Crossref
Veredito

Skill de referência técnica muito bem estruturada para quem trabalha com OJS. A verificação contra fonte oficial (pkp-lib) e ausência de alucinação em constantes é diferencial sério, mas o escopo é nicho — ideal para equipes de revistas acadêmicas e instituições com OJS.
README
A tradução para o português deste README ainda está na fila.
ojs-claude-skill — OJS Expert Skill for Claude
A comprehensive, source-verified Claude Code Agent Skill for OJS (Open Journal Systems) by PKP — covering plugin & theme development, REST API integration, system administration, and editorial workflow configuration for OJS 3.4.x / 3.5.x (with 3.3 differences noted).
Built and maintained by AL-NAKIB LTD.
What it does
Drop this skill into Claude Code and Claude becomes an OJS specialist that:
- Develops plugins — all 10 plugin categories with verified base-class APIs, the complete hooks catalog (arguments verified at call sites), settings UI for both 3.4 (Smarty/AjaxModal) and 3.5 (PluginSettingsController + Vue FormModal), migrations, scheduled tasks (post-Acron
HasTaskScheduler), queue jobs, custom editorial decisions - Builds themes — full
ThemePluginAPI, LESS variables, child themes, template-override hierarchy - Drives the REST API — all 118 endpoints (verified from the OpenAPI sources), JWT auth, COUNTER R5 SUSHI, OAI-PMH, plus a bundled stdlib-only Python client
- Administers installs —
config.inc.phpreference, jobs vs. scheduler (the big 3.4↔3.5 trap), upgrade procedure, CLI tools, security hardening, troubleshooting - Configures journals — workflow stages & decisions, roles, review process, DOIs/Crossref, ORCID, statistics
- Never hallucinates magic numbers — every integer constant (roles, stages, statuses, file stages, all 32 decision types…) extracted from real
pkp-libsource
All reference material was verified against official PKP documentation (docs.pkp.sfu.ca) and the pkp/ojs + pkp/pkp-lib source on branches stable-3_4_0 / stable-3_5_0.
Installation
Claude Code (personal skills)
git clone https://github.com/OWNER/ojs-claude-skill.git
# Windows
xcopy /E /I ojs-claude-skill\ojs-expert "%USERPROFILE%\.claude\skills\ojs-expert"
# macOS / Linux
cp -r ojs-claude-skill/ojs-expert ~/.claude/skills/ojs-expert
Project-level (share with a team via the repo)
Copy ojs-expert/ into your project's .claude/skills/ directory.
Then just talk to Claude about anything OJS — the skill auto-triggers on mentions of OJS, PKP, pkp-lib, config.inc.php, plugin/theme work, etc.
Structure
ojs-expert/
├── SKILL.md # router + core conventions + live-install safety rules
├── references/
│ ├── plugin-development.md # anatomy, categories, lifecycle API, migrations, jobs, 3.5 migration checklist
│ ├── hooks-catalog.md # ~50 hooks verified at call sites: args, ABORT semantics, removed-in-3.5
│ ├── ui-forms-handlers.md # Field* classes, FormComponent, handlers, authorization policies
│ ├── theme-development.md # ThemePlugin API, LESS variables, child themes, RTL, official-theme patterns
│ ├── frontend-templating.md # Smarty tag inventory, template variables, menus/sidebar machinery
│ ├── rest-api.md # full endpoint inventory, auth, SUSHI, OAI-PMH, curl recipes
│ ├── constants.md # verified integer constants (roles, stages, statuses, decisions…)
│ ├── admin-operations.md # install, config.inc.php, upgrade, jobs/scheduler, hardening
│ ├── editorial-workflow.md # settings map, roles, decisions, review, DOI/Crossref, ORCID
│ ├── architecture.md # Repo pattern, schemas, routers, directory layout
│ └── versions.md # release lines, LTS status, per-version diff matrix, docs map
└── scripts/
└── ojs_api.py # stdlib-only OJS REST API client (auth, pagination, upload)
Quick API client example
python ojs-expert/scripts/ojs_api.py \
--base "https://journal.example.com/index.php/myjournal" \
--token "$OJS_API_TOKEN" \
GET submissions -p status=1 -p count=20
Version targeting
| OJS line | Status (June 2026) | Skill coverage |
|---|---|---|
| 3.3.0-x | Current LTS | differences noted |
| 3.4.0-x | Stable | full |
| 3.5.0-x | Current / next LTS | full |
| 3.6 | Unreleased | roadmap notes only |
License
MIT © 2026 AL-NAKIB LTD. OJS and PKP are trademarks of their respective owners; this project is not affiliated with or endorsed by PKP.