hr-portal-skill
Provides access to the HR Portal frontend, including local dev server commands, routing structure, and backend API integration points.
Install
mkdir -p .claude/skills/hr-portal-skill && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/18547" && unzip -o skill.zip -d .claude/skills/hr-portal-skill && rm skill.zipInstalls to .claude/skills/hr-portal-skill
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Use this skill when developing, testing, debugging, or modifying code inside the HR Portal frontend (apps/hr-portal). It applies to handling HR administration tasks such as employee roster management, contract seeding, leave request approvals, attendance monitoring, payroll calculation, and recruitment pipelines.Key capabilities
- →Develop and test code within the HR Portal frontend
- →Manage employee roster and contract seeding
- →Handle leave request approvals and attendance monitoring
- →Perform payroll calculations
- →Integrate recruitment pipelines
How it works
This skill provides guidance and context for modifying the HR Portal frontend, including its folder structure, local running instructions, and related backend services.
Inputs & outputs
When to use hr-portal-skill
- →Fixing leave request approval logic
- →Updating employee roster interface
- →Debugging payroll calculation flows
- →Integrating new recruitment pipeline features
About this skill
HR Portal Development Skill
Use this skill when modifying, running, or analyzing the HR Portal frontend application.
Overview
- Location: apps/hr-portal/
- Local Port:
3003(runs onhttp://localhost:3003) - Key Target Role:
Role.HR - Authentication Entrypoint:
http://localhost:3001/auth/internal/login(MFA/TOTP required) - Related Backend Services:
hr-service(Port8086, API path/api/v1/hr/**)user-service(Port8082, API path/api/v1/users/**)notification-service(Port8090, API path/api/v1/notifications/**)
Folder Structure & Key Paths
- Layout File: layout.tsx - Configures page layout, sidebar navigation, and notification streams.
- Sub-routes (
src/app/dashboard/):attendance: Daily check-in registers, timesheet corrections, and shift planning.employees: Roster listing, contract updates, user creation and department role assignment.leaves: Dashboard for tracking company-wide leave balances, pending leave requests, and approval histories.payroll: Processing payslips, salary tier settings, tax calculations.recruitment: Hiring pipelines, open job requisitions, candidate profile trackers.
Development Workflow
How to Run Locally
To spin up the HR Portal, run the startup script:
# Run the bat script which starts docker, Maven JAR dependencies, and the dev server
.\apps\hr-portal\hrrun.bat
Credentials for Testing
- Test Email:
[email protected] - Password:
Password@123 - MFA Flow: Requires Google Authenticator MFA setup upon first login attempt.
Code Patterns & Best Practices
- Roster Modification: HR portal acts as the creator of new employee entries, publishing Kafka events (
EMPLOYEE_ONBOARDED) in the backend. When editing employee profiles, ensure correct field updates align with@hariventure/types. - Access Control: Confirm client components utilize appropriate session validation for
Role.HR.
When not to use it
- →When working on backend services unrelated to the HR Portal frontend
- →When the task does not involve HR administration tasks
- →When modifying parts of the application outside of `apps/hr-portal`
Limitations
- →Limited to the HR Portal frontend application (`apps/hr-portal`)
- →Requires specific local port configurations for the frontend and related backend services
- →Assumes the user has access to specific test credentials and MFA setup
How it compares
This skill focuses specifically on the HR Portal frontend, detailing its unique local development setup, authentication, and specific HR-related sub-routes and functionalities.
Compared to similar skills
hr-portal-skill side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| hr-portal-skill (this skill) | 0 | 17d | No flags | Beginner |
| javascript-typescript-typescript-scaffold | 3 | 3mo | Review | Beginner |
| server-actions | 1 | 6mo | No flags | Intermediate |
| open-notebook-lm-guidelines | 0 | 4mo | No flags | Advanced |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
javascript-typescript-typescript-scaffold
sickn33
You are a TypeScript project architecture expert specializing in scaffolding production-ready Node.js and frontend applications. Generate complete project structures with modern tooling (pnpm, Vite, N
server-actions
davepoon
This skill should be used when the user asks about "Server Actions", "form handling in Next.js", "mutations", "useFormState", "useFormStatus", "revalidatePath", "revalidateTag", or needs guidance on data mutations and form submissions in Next.js App Router.
open-notebook-lm-guidelines
RainLib
Core project guidelines, architecture, and UI styling instructions for the FerrisMind (openNotebookLm) AI workspace project. Use this whenever working on the frontend or backend of this project.
convex-realtime
waynesutton
Patterns for building reactive apps including subscription management, optimistic updates, cache behavior, and paginated queries with cursor-based loading
lifi-dev
mashharuki
>
api
birdgg
Create an agent team for full-stack feature development. One agent writes the Haskell Servant backend API, another builds the React frontend UI consuming that API. Use when asked to "build a feature", "add a new page", "create an endpoint with UI", or "fullstack feature".