Agent skill · software engineering · jeremylongshore
bamboohr-upgrade-migration
Migrate a BambooHR integration across SDK, OpenAPI, auth, dataset, or endpoint changes with pinned evidence, dual-read comparison, and rollback. Use when replacing legacy report/dataset calls or upgrading an official SDK. Trigger with "upgrade BambooHR", "BambooHR migration", or "BambooHR deprecated API".
Why this skill is useful
Provides specific migration patterns and code snippets for adapting to BambooHR API changes that the AI wouldn't generate on its own.
What it needs
Requires git 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 Upgrade and Migration Overview Move one contract boundary at a time and prove semantic parity on authorized data. A repository default branch is not a released package; a README install line is not registry evidence; and a v1 URL does not mean the operation is free from deprecation. 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 Dataset v1 data retrieval is deprecated in favor of POST /api/v2/datasets/{datasetName}/data. Saved/custom report operations carry replacement notices in the current SDK docs. Official Python and PHP SDK repositories were updated 2026-08-31. PHP package bamboohr/api 2.0.1 is on Packagist. Python bamboohr-sdk 1.0.0 is described in source but was absent from public PyPI and had no tag/release on 2026-09-11. Authentication Preserve the existing identity during endpoint/SDK migration unless auth change is the explicit workstream. If migrating API key to OAuth, treat registration, state validation, token storage, refresh, permission equivalence, and revocation as a separate staged migration with independent rollback. Instructions 1. Freeze the current adapter, dependency lock, endpoint inventory, auth mode, fields, filters, pagination, error mapping, retry policy, and production metrics. 2. Pin target OpenAPI/SDK evidence to an immutable commit, tag, or registry artifact. Verify package availability, integrity, license, and runtime support. 3. Diff operations, required parameters, auth scopes, status codes, response shapes, deprecations, pagination, retry behavior, and model return types. 4. Put old and new implementations behind the same application adapter. Keep writes on the old path while dual-reading a minimized approved cohort. 5. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/bamboohr-upgrade-migration