AGENT SKILL
pm-timely
Timely connector knowledge and safe action guide.
- License 许可
- AGPL-3.0
- 最近更新
- 2026-09-21
- Stars
- ★ 7
- Forks
- 0
01 前言 Front Matter
- name
- pm-timely
- description
- Timely connector knowledge and safe action guide.
03 SKILL.md 正文
pm-timely
Purpose
Reads users, projects, clients, calendar/time events, time entries (hours), tags (labels), and teams from the Timely API. Read-only: every Timely mutation endpoint requires a nested single-key JSON body envelope (e.g. {"client": {...}}) the engine's declarative write dialect cannot express.
Icon
- id: timely
- asset: icons/timely.svg
- source: upstream_registry
- review_status: upstream_seeded
- review_url: https://dev.timelyapp.com/
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
- account_id (required)
- base_url
- start_date
- bearer_token (secret) (required)
ETL Streams
- users:
- primary key: id
- fields: created_at(string), email(string), id(string), name(string), updated_at(string)
- projects:
- primary key: id
- fields: client_id(string), created_at(string), id(string), name(string), updated_at(string)
- clients:
- primary key: id
- fields: created_at(string), id(string), name(string), updated_at(string)
- events:
- primary key: id
- fields: created_at(string), duration(string), id(string), project_id(string), updated_at(string), user_id(string)
- hours:
- primary key: id
- fields: billable(boolean), billed(boolean), created_at(integer), day(string), deleted(boolean), external_id(string), from(string), id(integer), note(string), project_id(integer), to(string), uid(string), updated_at(integer), user_id(integer)
- labels:
- primary key: id
- fields: active(boolean), created_at(string), emoji(string), external_id(string), id(integer), name(string), parent_id(integer), sequence(integer), updated_at(string)
- teams:
- primary key: id
- fields: color(string), emoji(string), external_id(string), id(integer), name(string), project_ids(array), user_ids(array)
Sync Modes
- ETL sync modes: full_refresh_append, full_refresh_overwrite
Security
- read risk: external Timely API read of user, project, client, time event/entry, tag, and team data
- approval: none; read-only, no reverse-ETL writes
- Never pass secret values in chat, shell arguments, logs, docs, or JSON output.
Commands
Inspect as a manual
pm connectors inspect timely
Inspect as structured JSON
pm connectors inspect timely --json
Agent Rules
- Run pm connectors inspect timely 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
recipe-preview-approve-reverse-etl
Preview and approve a reverse ETL plan safely.
★ 7
recipe-github-prs-to-warehouse
Sync GitHub pull requests into the local warehouse.
★ 7
pm-zoom
Zoom connector knowledge and safe action guide.
★ 7
pm-zonka-feedback
Zonka Feedback connector knowledge and safe action guide.
★ 7
pm-zoho-invoice
Zoho Invoice connector knowledge and safe action guide.
★ 7
pm-zoho-inventory
Zoho Inventory connector knowledge and safe action guide.
★ 7