convez.ai
SkillAutomaçãoIntermediário
affifuddin-hazam

ESSNet Leave — Gerenciador de Férias para HRMS Orisoft

affifuddin-hazam/essnet-leave-claude-skill

Protocole férias no ESSNet sem reauthenticação, leia Teams para encontrar dias não registrados

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill para Claude Code que verifica, reconcilia e protocola solicitações de férias no portal ESSNet da Orisoft, controlando seu próprio navegador Chrome já autenticado via DevTools Protocol (CDP). Lê saldo de férias, registra ausências de um ou múltiplos dias, e escaneia Microsoft Teams para identificar dias de férias não registrados.

Instalação

$npx convez-ai affifuddin-hazam/essnet-leave-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
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Registrar solicitações de férias (anual, médica, não remunerada) no portal corporativo ESSNet
  • Conferir saldo de férias e períodos já cadastrados
  • Identificar automaticamente dias de férias anunciados no Teams que faltam ser protocolados

Veredito

Skill prático que resolve um problema real (falta de sincronização entre comunicação informal e HRMS corporativo). Exige setup manual de Chrome com porta de debug e credenciais, mas elimina autenticação repetida e MFA. Bem documentado, fluxo recomendado claro, e mecanismo de "dry-run" antes de submit reduz risco operacional.

README

A tradução para o português deste README ainda está na fila.

essnet-leave

A Claude Code skill to check, reconcile, and file leave on an Orisoft ESSNet HRMS portal — it drives your own already-signed-in Chrome over the DevTools Protocol (CDP), so there are no re-auth or MFA loops. It reads your leave list + entitlement balances, files single or multi-day applications, and (read-only) scans a Microsoft Teams chat for your own leave announcements to surface days you forgot to file.

Works with any portal running Orisoft ESSNet — login page titled "Employee Self-Service (ESSNet)", footer "Orisoft Technology Sdn Bhd" (commonly hosted at https://<company>-ess.com/hrmsnet).

Why CDP instead of a fresh headless browser

ESS portals sit behind corporate SSO/MFA. Spinning up a clean browser means fighting the login + MFA every run. Instead, this skill attaches to a Chrome you launched with a debug port and signed into once — it reuses that live session.

Install

Drop the folder into your Claude Code skills directory:

~/.claude/skills/essnet-leave/
├── SKILL.md
└── scripts/ess.py

Then in Claude Code just ask it to check or file your ESS leave, or run the script directly (below).

Requirements

  • Python 3.8+ with Playwright: pip install playwright
  • Chrome launched with a debug port (any profile; sign into ESS once in it):
    chrome.exe --remote-debugging-port=9222 --user-data-dir=C:\some\profile
    
  • Config via environment variables (or pass the flags on each call):
    set ESS_BASE=https://YOURCO-ess.com/hrmsnet
    set ESS_USER=<your id>
    set ESS_PASS=<your password>
    
  • For teams-scan: the same Chrome must have a signed-in Teams tab open.

Credentials are read at runtime only — nothing is stored in this repo.

Usage

python scripts/ess.py login
python scripts/ess.py list --from 01/01/2026 --to 31/12/2026 [--json]
python scripts/ess.py entitlement --year 2026
python scripts/ess.py file --start 14/01/2026 --end 16/01/2026 \
        --type AL --reason EMER --period F --remarks "EMERGENCY LEAVE" [--submit]
python scripts/ess.py teams-scan --group "Portal Support" --back-to 2026-01-01 [--out msgs.json]

ESS dates are DD/MM/YYYY. teams-scan --back-to is YYYY-MM-DD.

--type--reason--period
AL AnnualMC MedicalABS AbsentMED MedicalF Full day
UPL UnpaidCL CompassionateEMER EmergencyPER Personal1 1st half
HL HospitalizationMRL MarriageHOS HospitalizationOTH Others2 2nd half
PL PaternityHOME / CNY / MAT / PAT

Consecutive days → one application via --start/--end (one row per working day; don't span a weekend in a single range).

Recommended flow

  1. entitlement → read your balances.
  2. list → what's already on file.
  3. teams-scan → your own leave announcements; diff against step 2 to find unfiled days.
  4. Build a filing plan grouped by consecutive-day ranges + reason.
  5. file (no --submit) to stage and review → re-run with --submit.
  6. list again to verify everything landed.

Safety

  • file never submits unless you pass --submit. Without it, the form is filled and left on screen for review.
  • teams-scan is strictly read-only — it only scrolls and reads the DOM. It never types into or sends to any chat.
  • It's live HR: each submit creates a real workflow request to your manager. Confirm dates, type, reason, and balance impact first.

ESSNet quirks handled

QuirkHandling
Date textboxes are jQuery-UI datepickers; a plain .value reverts on postbackset value + dispatch input/change/blur
Leave Form throws "Invalid access" on a direct URLopen it via the in-app menu anchor (referrer check)
Submit fires a confirm() then navigates → click hangsauto-accept dialog + no_wait_after, poll for "Process completed successfully"
Sessions expire fast on idleevery command re-logs-in if it lands on the login page
Per-day Reason is locked to the header Reasonone reason per application — split batches by reason
Entitlement is per calendar yearpass --year; Dec leave belongs to that year

Disclaimer

Not affiliated with or endorsed by Orisoft Technology Sdn Bhd or any employer. Use only on your own account, in line with your company's policies. Provided as-is.

License

MIT © 2026 Affifuddin Mohd Hazam

Ver o original no GitHub

Bom para

Relacionados