core
Automate GitHub-centric dev workflows: create branches/PRs from changes, diagnose/fix CI failures and Playwright flakiness, resolve review comments, perform adversarial/code quality reviews, investigate Datadog production issues, manage AWS Cognito users, seed test data, link monorepo packages, and analyze sessions for Claude Code optimizations.
npx claudepluginhub clipboardhealth/core-utils --plugin coreComponent Overview
Component Details
Skills (12)
Perform an adversarial review of proposed work. Use ONLY when the user explicitly types /adversarial-review. Never auto-trigger, even if the user mentions reviewing, questioning, or challenging their approach.
Use when looking up Cognito user details by sub UUID, finding duplicate accounts sharing phone or email, analyzing which duplicates to keep vs delete, or fixing orphaned UNCONFIRMED signups. Symptoms include 403 Forbidden on login, multiple accounts for same phone, backend sync issues.
Commit, push, and open a PR. Use when the user wants to ship changes, create a pull request, or says things like 'commit and push', 'open a PR', 'ship it', 'send it', 'create a PR for this', or 'push this up'.
Investigate production issues by querying Datadog logs, metrics, and APM traces, then correlating findings with the codebase. Use this skill whenever the user mentions production errors, Datadog, observability, log investigation, latency spikes, error rate increases, 500s, trace IDs, monitor alerts, or wants to debug any service issue in a deployed environment.
Analyze and fix CI failures for a GitHub pull request. Use this when CI checks are failing, the build is red, or you need to diagnose GitHub Actions failures. Triggers on: 'fix CI', 'CI is failing', 'checks failed', 'build is broken', 'tests failing in CI', 'why is CI red', or any request to investigate and resolve PR check failures.
Debug and fix flaky Playwright E2E tests using Playwright reports and Datadog. Use this skill when investigating intermittent Playwright test failures, triaging flaky E2E tests, or fixing test instability.
Iteratively commit, push, and address PR feedback until CI passes and comments are resolved. Use this skill when the user wants to get a PR to a mergeable state, fix CI and address review comments in a loop, or says things like 'iterate on my PR', 'make this PR pass', 'fix everything on the PR', 'get this PR ready to merge', or 'keep going until CI is green'.
Analyze the current session for agent efficiency, quality, and actionable improvements. Use this skill when the user says things like "learn from this session", "session retro", "what went well", "how did the agent do", "what should I improve", "review this session", "session review", or any request to reflect on how the current session went. Also use when the user wants to extract learnings, identify friction, or improve their workflow based on what just happened.
Use Clipboard's internal CLI to link and unlink @clipboard-health packages across repositories for local development. Use when testing local package changes, linking @clipboard-health packages between repos, or using the cbh CLI local-package command.
Trigger seed data generation for test environments via GitHub Actions. Use when asked to seed, create test data, or set up HCPs/facilities/shifts.
Instructions for simplifying code.
Get unresolved review comments from a GitHub pull request. Use this skill when the user asks about PR feedback, review comments, unresolved threads, what reviewers said, CodeRabbit nitpicks, or wants to address PR review feedback. Also use when the user says 'check my PR', 'what's left on my PR', or 'resolve comments'.
Hooks (1)
README
core-utils
Clipboard's core libraries and utilities. See individual package `README`s for specific library details.
Table of contents
Libraries
- ai-rules: Pre-built AI agent rules for consistent coding standards.
- analytics: Type-safe analytics wrapper around our third-party analytics provider for user identification and event tracking.
- background-jobs-adapter: Minimal adapter interface for background jobs operations supporting Mongo and Postgres implementations.
- config: Type-safe static configuration management: a pure function to resolve, validate against a Zod schema, and freeze configuration values.
- contract-core: Shared Zod schemas for Clipboard's contracts.
- embedex: Embed shared text and code snippets from source files into destination files.
- eslint-config: Our ESLint configuration.
- eslint-plugin: Clipboard's ESLint Plugin
- example-nestjs: A NestJS application using our libraries, primarily for end-to-end testing.
- execution-context: A lightweight Node.js utility for managing execution contexts and metadata aggregation using AsyncLocalStorage.
- json-api: TypeScript-friendly utilities for adhering to the JSON:API specification.
- json-api-nestjs: TypeScript-friendly utilities for adhering to the JSON:API specification with NestJS.
- mongo-jobs: MongoDB-powered background jobs.
- notifications: Send notifications through third-party providers.
- nx-plugin: An Nx plugin with generators to manage libraries and applications.
- phone-number: Phone number utility functions.
- playwright-reporter-llm: Playwright reporter that outputs structured JSON for LLM agents. Minimal console output, flat schema, easy to filter to failures.
- rules-engine: A pure functional rules engine to keep logic-dense code simple, reliable, understandable, and explainable.
- testing-core: TypeScript-friendly testing utilities.
- util-ts: TypeScript utilities.
Local development commands
See package.json scripts for a complete list of commands.
See Nx CLI Commands for options or npx nx --help.
# Install dependencies
npm install
# Build, lint, and test only changed files from `main`, helpful prior to opening PRs
npm run affected
# For the paranoid: build, lint, and test everything
npm run all
# Install a dependency in a specific package
npm install --workspace packages/[PROJECT_NAME] [DEPENDENCY]
# Run specific commands against a specific packages
npx nx run [PROJECT_NAME]:[COMMAND]
# Upgrade Nx
npx nx migrate latest && \
npx syncpack fix && \
npm install && \
npx nx migrate --runMigrations --ifExists
Adding or porting libraries
See our Nx generator plugin.
Contributing
See CONTRIBUTING.md.
Similar Plugins
developer-essentials
Essential developer skills for monorepos, debugging, testing, and build optimization
Help us improve
Share bugs, ideas, or general feedback.