← Back to Skills Marketplace
mikeling

iHRFlow HR Assistant

by MikeLing · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
299
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install ihrflow-hr
Description
iHRFlow HR assistant for recruiting. Use when searching candidates, managing positions, scheduling interviews, advancing pipeline, or viewing recruitment stats.
README (SKILL.md)

iHRFlow HR Assistant

You are an AI HR assistant for the iHRFlow talent management platform. You interact with iHRFlow through the MCP protocol using {baseDir}/scripts/mcp-call.sh.

Setup

On first use each conversation, initialize and authenticate:

{baseDir}/scripts/mcp-call.sh init
{baseDir}/scripts/mcp-call.sh login

Session is cached automatically. If any call returns an auth error, re-run both commands.

Calling Tools

{baseDir}/scripts/mcp-call.sh call \x3Ctool_name> '\x3Cjson_args>'

Output is clean JSON. For full parameter details, read {baseDir}/references/api-reference.md.

Reading Resources

{baseDir}/scripts/mcp-call.sh resource "ihrflow://positions/active"

Tool Quick Reference

Tool Description Required Args
login Authenticate user session username, password
search_candidates Search resumes by keyword keyword
get_resume_detail Get full resume resume_id
add_resume_note Add note to resume resume_id, content
recommend_candidate_for_position Recommend candidate to position resume_id, position_id
list_positions List positions (filterable)
get_position_detail Get position details position_id
get_position_candidates List candidates for position position_id
update_position_status Change position status position_id, status
create_recruitment_need Create new position title, department
list_interviews List interviews (filterable)
get_interview_detail Get interview details interview_id
create_interview Schedule interview resume_id, position_id, interviewer_id, scheduled_at
cancel_interview Cancel interview interview_id
reschedule_interview Reschedule interview interview_id, new_date, new_time
update_screening_status Advance/reject in pipeline resume_id, action
submit_interview_feedback Submit interview evaluation interview_id, passed, feedback
search_talent AI semantic talent search query
get_recruitment_statistics Recruitment stats overview
get_today_schedule Today's schedule

Resources: ihrflow://recruitment/overview, ihrflow://positions/active

Workflows

1. Daily Briefing

get_today_schedule -> get_recruitment_statistics -> resource ihrflow://positions/active -> summarize in table

2. Find Candidates for Position

get_position_detail -> search_talent (using requirements) -> get_resume_detail (top matches) -> recommend_candidate_for_position

3. Interview Lifecycle

create_interview -> (after interview) submit_interview_feedback -> update_screening_status (hr_approve/final_approve or reject)

4. Create & Publish Position

create_recruitment_need -> update_position_status (status="active") -> search_talent

5. Pipeline Review

get_position_candidates -> get_resume_detail per candidate -> update_screening_status -> add_resume_note

6. Reschedule Interview

list_interviews (status="scheduled") -> reschedule_interview

Domain Knowledge

Screening pipeline:

pending -> hr_approved -> [exam_pending -> exam_passed] -> dept_approved -> [interview cycles] -> final_approved

Each stage: approve (advance) or reject (end). Exam phase is managed outside MCP tools. Use update_screening_status with actions: hr_approve, hr_reject, dept_approve, dept_reject, final_approve, final_reject.

Position lifecycle: pending -> active -> paused \x3C-> active -> closed

Interview states: to_be_scheduled -> scheduled -> pending_evaluation -> completed (or cancelled)

Multi-tenant: tenant_id at login determines data visibility and permissions.

Response Formatting

  • Lists: markdown tables with key columns
  • Details: sectioned display, bold key info
  • Pipeline status: HR初筛 ✅ -> 部门筛选 🔄 -> 面试 ⏳ -> 终审 ⏳

Error Handling & Stop Conditions

  • Auth error: re-run init + login
  • Permission denied: inform user, suggest contacting admin
  • Never guess IDs — always look up first
  • Always confirm destructive actions (cancel, reject) before executing
  • No results: suggest broader search terms

When NOT to Use

This skill does NOT cover: user/role/tenant administration, exam management, file uploads, bulk imports, system configuration.

Language

Backend data is in Chinese. Interact with user in Chinese. Enum values (status, action) are in English.

Usage Guidance
This skill appears to be what it says: an MCP client for iHRFlow using curl+jq. Before installing: (1) Verify the IHRFLOW_MCP_URL points to your trusted MCP server (don't point it to an unknown host); (2) Be aware you must provide username/password (and optionally tenant_id/API key); these are stored in your OpenClaw configuration/environment — consider using the platform vault/secrets feature rather than plain environment variables; (3) The helper stores a session id under /tmp for the current user — on multi-user hosts review permissions and remove stale session files if needed; (4) Source/homepage is not provided in the skill metadata — if you don't already trust the provider, try to obtain the upstream repository or vendor contact before use. If you want higher assurance, ask the publisher for a verifiable source (GitHub repo or vendor site) and/or audit the MCP server endpoint and its required transport API key policy.
Capability Analysis
Type: OpenClaw Skill Name: ihrflow-hr Version: 1.0.0 The ihrflow-hr skill bundle is a legitimate integration for the iHRFlow talent management platform, implementing a Model Context Protocol (MCP) client via a shell script (scripts/mcp-call.sh). The script uses standard tools like curl and jq to interact with a user-defined backend URL (IHRFLOW_MCP_URL) and handles authentication and tool execution as described in the comprehensive documentation (SKILL.md, README.md, and api-reference.md). No evidence of data exfiltration, malicious execution, or prompt injection was found; the requested shell and network permissions are appropriate for its stated purpose of communicating with an external HR API.
Capability Assessment
Purpose & Capability
Name/description (iHRFlow HR assistant) match the implemented behavior: the helper script talks to an MCP endpoint and exposes recruiting-related tools. Required binaries (curl, jq) and required env vars (MCP URL, username, password) are appropriate for an HTTP+JSON CLI client.
Instruction Scope
SKILL.md instructions only direct the agent to run the included helper script (init/login/call/resource) and to call iHRFlow MCP tools and resources. The instructions do not ask the agent to read unrelated system files, exfiltrate arbitrary data, or call unexpected endpoints beyond the configured MCP URL. Network and shell permissions are declared and expected.
Install Mechanism
No install spec; skill is instruction-only with an included shell helper script. No remote downloads or arbitrary install URLs. This is low-risk from an installer perspective.
Credentials
The skill requires IHRFLOW_MCP_URL, IHRFLOW_USERNAME, IHRFLOW_PASSWORD which are proportionate. Documentation and changelog also mention optional IHRFLOW_TENANT_ID and IHRFLOW_API_KEY (transport API key) even though only three env vars are declared as required — minor inconsistency but these optional vars are sensible. Operational note: credentials are expected to be provided via environment/config and the script will send X-API-Key and session headers if set; storing passwords in env and session IDs in files has usual risks.
Persistence & Privilege
The skill does not request always:true and does not modify other skills. It writes a session id to /tmp/ihrflow-mcp-session-${USER}, which is normal for a client but has typical risks: session token stored on disk, potential for race/permission issues in shared environments. No other elevated privileges requested.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install ihrflow-hr
  3. After installation, invoke the skill by name or use /ihrflow-hr
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
iHRFlow HR assistant: 20 MCP tools for recruiting, candidate search, interview scheduling, pipeline management, and recruitment statistics
Metadata
Slug ihrflow-hr
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is iHRFlow HR Assistant?

iHRFlow HR assistant for recruiting. Use when searching candidates, managing positions, scheduling interviews, advancing pipeline, or viewing recruitment stats. It is an AI Agent Skill for Claude Code / OpenClaw, with 299 downloads so far.

How do I install iHRFlow HR Assistant?

Run "/install ihrflow-hr" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is iHRFlow HR Assistant free?

Yes, iHRFlow HR Assistant is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does iHRFlow HR Assistant support?

iHRFlow HR Assistant is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created iHRFlow HR Assistant?

It is built and maintained by MikeLing (@mikeling); the current version is v1.0.0.

💬 Comments