AGENT SKILL

pm-factorial

Factorial connector knowledge and safe action guide.

License 许可
AGPL-3.0
所属仓库
polymetrics-ai/cli
最近更新
2026-09-21
Stars
★ 7
Forks
0

01 前言 Front Matter

name
pm-factorial
description
Factorial connector knowledge and safe action guide.

03 SKILL.md 正文

pm-factorial

Purpose

Reads FactorialHR employees, teams, time-off leaves, leave types, and locations through the Factorial REST API.

Icon

Capabilities

  • check=true catalog=true read=true write=false query=false
  • Integration type: api

Authentication

  • Use pm credentials add with --from-env or --value-stdin for secret fields.

Configuration

  • base_url
  • mode
  • api_key (secret) (required)

ETL Streams

  • employees:
    • primary key: id
    • cursor: updated_at
    • fields: active(boolean), birthday_on(string), company_id(integer), created_at(string), email(string), first_name(string), full_name(string), gender(string), id(integer), last_name(string), legal_entity_id(integer), location_id(integer), manager_id(integer), team_ids(array), terminated_on(string), updated_at(string)
  • teams:
    • primary key: id
    • fields: avatar(string), company_id(integer), description(string), employee_ids(array), id(integer), lead_ids(array), name(string)
  • leaves:
    • primary key: id
    • cursor: updated_at
    • fields: approved(boolean), created_at(string), description(string), employee_id(integer), finish_on(string), half_day(string), id(integer), leave_type_id(integer), start_on(string), updated_at(string)
  • leave_types:
    • primary key: id
    • fields: active(boolean), approval_required(boolean), color(string), company_id(integer), id(integer), identifier(string), name(string)
  • locations:
    • primary key: id
    • fields: address_line_1(string), city(string), company_id(integer), country(string), id(integer), main(boolean), name(string), postal_code(string), state(string), timezone(string)

Sync Modes

  • ETL sync modes: full_refresh_append, full_refresh_overwrite, full_refresh_overwrite_deduped, incremental_append, incremental_append_deduped

Security

  • read risk: external Factorial API read of employee, team, and time-off data
  • approval: none; read-only
  • Never pass secret values in chat, shell arguments, logs, docs, or JSON output.

Commands

Inspect as a manual

pm connectors inspect factorial

Inspect as structured JSON

pm connectors inspect factorial --json

Agent Rules

  • Run pm connectors inspect factorial before creating credentials or plans.
  • Use --json only when the caller needs structured output; use the manual for human-readable guidance.
  • Never ask the user to paste secret values into chat.

04 同仓库更多 Skills