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 GitHubSkill 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-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
- 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 Annual | MC Medical | ABS Absent | MED Medical | F Full day |
UPL Unpaid | CL Compassionate | EMER Emergency | PER Personal | 1 1st half |
HL Hospitalization | MRL Marriage | HOS Hospitalization | OTH Others | 2 2nd half |
PL Paternity | HOME / 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
entitlement→ read your balances.list→ what's already on file.teams-scan→ your own leave announcements; diff against step 2 to find unfiled days.- Build a filing plan grouped by consecutive-day ranges + reason.
file(no--submit) to stage and review → re-run with--submit.listagain to verify everything landed.
Safety
filenever submits unless you pass--submit. Without it, the form is filled and left on screen for review.teams-scanis 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
| Quirk | Handling |
|---|---|
Date textboxes are jQuery-UI datepickers; a plain .value reverts on postback | set value + dispatch input/change/blur |
| Leave Form throws "Invalid access" on a direct URL | open it via the in-app menu anchor (referrer check) |
Submit fires a confirm() then navigates → click hangs | auto-accept dialog + no_wait_after, poll for "Process completed successfully" |
| Sessions expire fast on idle | every command re-logs-in if it lands on the login page |
| Per-day Reason is locked to the header Reason | one reason per application — split batches by reason |
| Entitlement is per calendar year | pass --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