Agent skill · software engineering · jeremylongshore
bamboohr-sdk-patterns
Select and wrap BambooHR's official Python or PHP SDK, or a narrow direct HTTP adapter, with tenant isolation and typed errors. Use when implementing a reusable client or replacing an unverified community package. Trigger with "BambooHR SDK", "BambooHR client", or "BambooHR integration patterns".
Why this skill is useful
Adds a production-ready TypeScript client for the BambooHR API with error handling and type safety, which the AI cannot generate on its own.
What it needs
Requires typescript installed locally. Requires bamboohr account access. About 2k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
BambooHR SDK and Client Patterns Overview Build a small application-owned adapter around a verified BambooHR transport. Keep BambooHR models and error details at the adapter boundary so upstream SDK regeneration or endpoint migration does not ripple through business logic. Prerequisites The target repository or integration path and the requested operator outcome. The tenant, identity, and data scope only when approved live work is in scope. The current evidence register plus customer-specific permissions and agreements. Current Contract BambooHR/bhr-api-python and BambooHR/bhr-api-php are official repositories. bamboohr/api 2.0.1 is published on Packagist. The Python repository documents bamboohr-sdk 1.0.0, but public PyPI did not expose that distribution on 2026-09-11 and the repository had no tag or release. Treat it as source-visible, not registry-proven. No official npm BambooHR SDK was found; a TypeScript integration should use a narrow HTTP adapter rather than claim an official package. Authentication Expose constructors for OAuth and API-key identities, not raw headers. Bind each client to one validated tenant subdomain. If OAuth refresh is enabled, persist rotated tokens through the caller-owned callback; the Python SDK does not store them across restarts. Instructions 1. Inventory language, package lock, existing HTTP client, and supported auth modes with Read, Glob, and Grep. 2. Verify the selected package in its public registry at implementation time. For an approved source install, pin an immutable commit and record its hash, license, provenance, and update owner. 3. Define an adapter with explicit operations such as getCompanyInformation, listEmployees, and queryDatasetV2; do not expose an arbitrary URL method to untrusted callers. 4. Normalize errors into status, operation, retryability, request ID, and a redacted summary. Preserve the original exception only in protected logs. 5. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/bamboohr-sdk-patterns