convez.ai
SkillDesenvolvimento WebAvançado
global-prog

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 GitHub
InicialPluginScore · de 0 a 100

Skill 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-skill

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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 ThemePlugin API, 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.php reference, 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-lib source

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 lineStatus (June 2026)Skill coverage
3.3.0-xCurrent LTSdifferences noted
3.4.0-xStablefull
3.5.0-xCurrent / next LTSfull
3.6Unreleasedroadmap 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.

Ver o original no GitHub

Bom para

Relacionados