all publishers

usefulsoftwareco

@usefulsoftwareco source repo

43 published skills

  1. ▌
    Graphite 2 · usefulsoftwareco
    Manage Git branches and PRs using Graphite CLI (gt) instead of raw git commands. Use this skill when committing code changes, amending commits, creating branches, or submitting pull requests. Triggers on git commit, git push, creating PRs, amending changes, stacking branches, or any version control workflow.
    4.3k repo stars
  2. ▌
    CLI Release 2 · usefulsoftwareco
    Runbook for releasing the `executor` CLI package (stable and beta). Covers scope of what ships with the CLI, user-facing changelog conventions, Changesets + Version Packages PR flow, beta train entry/exit, and owner preferences. Use when the user asks to cut a release, prepare release notes, enter/exit a beta train, or write changesets for the CLI.
    4.3k repo stars
  3. ▌
    Stack 2 · usefulsoftwareco
    User guide for the local squash-safe `stack` CLI for stacked PR repair. Use when someone asks how to inspect, track, sync, merge, document, or undo stacked pull requests in squash-merge repositories. Prefer this tool over GitHub's `gh stack` command for this workflow.
    4.3k repo stars
  4. ▌
    Emulate 2 · usefulsoftwareco
    Use the @executor-js/emulate service emulators (GitHub, Google, Stripe, Resend, WorkOS, …) to test integrations for real — full OpenAPI specs, working OAuth flows, mintable credentials, and a request ledger for assertions. Use when a test or demo needs a real-shaped upstream API, an OAuth/OIDC provider, a spec to feed addSpec, or proof that a request actually landed.
    4.3k repo stars
  5. ▌
    Effect Client Wrapper 2 · usefulsoftwareco
    Pattern for wrapping third-party SDK clients (Stripe, Resend, AWS, etc.) with Effect. Use when creating Effect services that wrap external libraries with Promise-based APIs. Provides type-safe error handling, automatic tracing, and clean dependency injection via the "use" pattern.
    4.3k repo stars
  6. ▌
    Effect HTTP Testing 2 · usefulsoftwareco
    Testing Effect HttpApi services end-to-end. Use when writing tests that involve Effect's HttpApi, HttpApiBuilder, HttpClient, HttpServer, or when testing any HTTP service/plugin built with @effect/platform. Covers proper layer composition, test server setup, HttpClient injection, and common pitfalls.
    4.3k repo stars
  7. ▌
    Prod Telemetry 2 · usefulsoftwareco
    Query Executor's production telemetry — Axiom traces (executor-cloud dataset), prod Postgres via PlanetScale, PostHog product analytics — through the Executor MCP. Use when investigating prod errors, latency, usage, churn signals, or verifying a deploy's telemetry; includes the dataset field layout, working APL recipes, and the error-attribution join.
    4.3k repo stars
  8. ▌
    Warden Security Review 2 · usefulsoftwareco
    Run Warden security scans in this repo using Sentry's warden-skills. Use when asked to audit security, scan with Warden, investigate authz/data-exfil/code-execution/GitHub Actions risks, or triage Warden findings.
    4.3k repo stars
  9. ▌
    Self Contained Modals 2 · usefulsoftwareco
    Build modals/dialogs self-contained: form and in-flight state lives inside, closing unmounts it. Use when writing or reviewing a modal/dialog, especially one that owns async work (OAuth popups, timers, subscriptions, AbortControllers). Catches the stuck-on-Connecting class of lifecycle-leak bugs.
    4.3k repo stars
  10. ▌
    Wrdn Package Boundaries 2 · usefulsoftwareco
    Preserve workspace package boundaries. Use when lint flags relative imports that cross package roots.
    4.3k repo stars
  11. ▌
    Effect Atom Optimistic Updates 2 · usefulsoftwareco
    Pattern for implementing optimistic UI updates with effect-atom in this codebase. Use when adding optimistic behavior to a query atom + its mutations (action toggles, list adds/removes, inline edits). DO NOT roll your own pending-state with React state, Maps, or custom merge helpers — `Atom.optimistic` + `Atom.optimisticFn` already handle racing, refresh, and waiting correctly.
    4.3k repo stars
  12. ▌
    Wrdn Effect Promise Exit 2 · usefulsoftwareco
    Replace React/effect-atom mutation handlers that use promise-mode plus try/catch with promiseExit and explicit Exit handling. Use when lint or review flags try/catch around useAtomSet mutation calls, especially UI handlers that set error/busy state after a failed mutation.
    4.3k repo stars
  13. ▌
    Wrdn Effect Typed Errors 2 · usefulsoftwareco
    Fix lint findings that use untyped JavaScript error handling instead of Effect typed failures. Use when lint flags new Error, throw, try/catch, Promise.catch, Promise.reject, instanceof Error, unknown error message/stringification, or redundant helpers that only construct tagged errors.
    4.3k repo stars
  14. ▌
    Wrdn Effect Vitest Tests 2 · usefulsoftwareco
    Keep tests deterministic and Effect-aware. Use when lint flags direct vitest imports or conditional assertions inside tests.
    4.3k repo stars
  15. ▌
    Wrdn Effect Atom Optimistic 2 · usefulsoftwareco
    Detects hand-rolled optimistic-update plumbing in React code that should be using effect-atom's Atom.optimistic and Atom.optimisticFn instead. Run on diffs touching packages/react/src/api/atoms.tsx, packages/react/src/pages/**/*.tsx, or any file that imports an effect-atom mutation atom from ./api/atoms. The hand-rolled patterns race on concurrent mutations and the codebase has chosen the effect-atom primitives as the canonical answer.
    4.3k repo stars
  16. ▌
    Wrdn Typescript Type Safety 2 · usefulsoftwareco
    Remove TypeScript escape hatches. Use when lint flags @ts-nocheck or similar broad type bypasses.
    4.3k repo stars
  17. ▌
    Wrdn Effect Schema Boundaries 2 · usefulsoftwareco
    Normalize unknown or loosely typed data at boundaries with Effect Schema, named guards, or typed adapters. Use when lint flags double casts, inline object assertions, unknown shape probing, or ad hoc property checks on unknown values.
    4.3k repo stars
  18. ▌
    Wrdn Effect Raw Fetch Boundary 2 · usefulsoftwareco
    Route HTTP through Effect boundaries instead of raw fetch. Use when lint flags executor/no-raw-fetch or when adding networked protocol/provider code.
    4.3k repo stars
  19. ▌
    Wrdn Effect Atom Reactivity Keys 2 · usefulsoftwareco
    Add reactivityKeys to effect-atom write mutation calls. Use when lint flags a useAtomSet mutation call that mutates data without invalidation keys.
    4.3k repo stars
  20. ▌
    Wrdn Effect Value Inferred Types 2 · usefulsoftwareco
    Replace duplicated object API types with types inferred from the runtime value or factory that owns the shape. Use when lint or review flags an interface/type alias that mirrors a returned object such as a plugin extension, client surface, route map, or handler table.
    4.3k repo stars
  21. ▌
    Wrdn Effect Schema Inferred Types 2 · usefulsoftwareco
    Replace duplicated TypeScript shape declarations next to Effect Schema definitions with schema-derived types. Use when lint or review flags an interface/type alias that repeats fields already described by a nearby Schema.Struct, Schema.Union, Schema.TaggedStruct, or other Effect Schema model.
    4.3k repo stars
  22. ▌
    Graphite · usefulsoftwareco
    Manage Git branches and PRs using Graphite CLI (gt) instead of raw git commands. Use this skill when committing code changes, amending commits, creating branches, or submitting pull requests. Triggers on git commit, git push, creating PRs, amending changes, stacking branches, or any version control workflow.
    4.3k repo stars
  23. ▌
    CLI Release · usefulsoftwareco
    Runbook for releasing the `executor` CLI package (stable and beta). Covers scope of what ships with the CLI, user-facing changelog conventions, Changesets + Version Packages PR flow, beta train entry/exit, and owner preferences. Use when the user asks to cut a release, prepare release notes, enter/exit a beta train, or write changesets for the CLI.
    4.3k repo stars
  24. ▌
    Stack · usefulsoftwareco
    User guide for the local squash-safe `stack` CLI for stacked PR repair. Use when someone asks how to inspect, track, sync, merge, document, or undo stacked pull requests in squash-merge repositories. Prefer this tool over GitHub's `gh stack` command for this workflow.
    4.3k repo stars
  25. ▌
    Emulate · usefulsoftwareco
    Use the @executor-js/emulate service emulators (GitHub, Google, Stripe, Resend, WorkOS, …) to test integrations for real — full OpenAPI specs, working OAuth flows, mintable credentials, and a request ledger for assertions. Use when a test or demo needs a real-shaped upstream API, an OAuth/OIDC provider, a spec to feed addSpec, or proof that a request actually landed.
    4.3k repo stars
  26. ▌
    Effect Client Wrapper · usefulsoftwareco
    Pattern for wrapping third-party SDK clients (Stripe, Resend, AWS, etc.) with Effect. Use when creating Effect services that wrap external libraries with Promise-based APIs. Provides type-safe error handling, automatic tracing, and clean dependency injection via the "use" pattern.
    4.3k repo stars
  27. ▌
    Effect HTTP Testing · usefulsoftwareco
    Testing Effect HttpApi services end-to-end. Use when writing tests that involve Effect's HttpApi, HttpApiBuilder, HttpClient, HttpServer, or when testing any HTTP service/plugin built with @effect/platform. Covers proper layer composition, test server setup, HttpClient injection, and common pitfalls.
    4.3k repo stars
  28. ▌
    Prod Telemetry · usefulsoftwareco
    Query Executor's production telemetry — Axiom traces (executor-cloud dataset), prod Postgres via PlanetScale, PostHog product analytics — through the Executor MCP. Use when investigating prod errors, latency, usage, churn signals, or verifying a deploy's telemetry; includes the dataset field layout, working APL recipes, and the error-attribution join.
    4.3k repo stars
  29. ▌
    Warden Security Review · usefulsoftwareco
    Run Warden security scans in this repo using Sentry's warden-skills. Use when asked to audit security, scan with Warden, investigate authz/data-exfil/code-execution/GitHub Actions risks, or triage Warden findings.
    4.3k repo stars
  30. ▌
    Self Contained Modals · usefulsoftwareco
    Build modals/dialogs self-contained: form and in-flight state lives inside, closing unmounts it. Use when writing or reviewing a modal/dialog, especially one that owns async work (OAuth popups, timers, subscriptions, AbortControllers). Catches the stuck-on-Connecting class of lifecycle-leak bugs.
    4.3k repo stars
  31. ▌
    Wrdn Package Boundaries · usefulsoftwareco
    Preserve workspace package boundaries. Use when lint flags relative imports that cross package roots.
    4.3k repo stars
  32. ▌
    Effect Atom Optimistic Updates · usefulsoftwareco
    Pattern for implementing optimistic UI updates with effect-atom in this codebase. Use when adding optimistic behavior to a query atom + its mutations (action toggles, list adds/removes, inline edits). DO NOT roll your own pending-state with React state, Maps, or custom merge helpers — `Atom.optimistic` + `Atom.optimisticFn` already handle racing, refresh, and waiting correctly.
    4.3k repo stars
  33. ▌
    Wrdn Effect Promise Exit · usefulsoftwareco
    Replace React/effect-atom mutation handlers that use promise-mode plus try/catch with promiseExit and explicit Exit handling. Use when lint or review flags try/catch around useAtomSet mutation calls, especially UI handlers that set error/busy state after a failed mutation.
    4.3k repo stars
  34. ▌
    Wrdn Effect Typed Errors · usefulsoftwareco
    Fix lint findings that use untyped JavaScript error handling instead of Effect typed failures. Use when lint flags new Error, throw, try/catch, Promise.catch, Promise.reject, instanceof Error, unknown error message/stringification, or redundant helpers that only construct tagged errors.
    4.3k repo stars
  35. ▌
    Wrdn Effect Vitest Tests · usefulsoftwareco
    Keep tests deterministic and Effect-aware. Use when lint flags direct vitest imports or conditional assertions inside tests.
    4.3k repo stars
  36. ▌
    Wrdn Effect Atom Optimistic · usefulsoftwareco
    Detects hand-rolled optimistic-update plumbing in React code that should be using effect-atom's Atom.optimistic and Atom.optimisticFn instead. Run on diffs touching packages/react/src/api/atoms.tsx, packages/react/src/pages/**/*.tsx, or any file that imports an effect-atom mutation atom from ./api/atoms. The hand-rolled patterns race on concurrent mutations and the codebase has chosen the effect-atom primitives as the canonical answer.
    4.3k repo stars
  37. ▌
    Wrdn Typescript Type Safety · usefulsoftwareco
    Remove TypeScript escape hatches. Use when lint flags @ts-nocheck or similar broad type bypasses.
    4.3k repo stars
  38. ▌
    Wrdn Effect Schema Boundaries · usefulsoftwareco
    Normalize unknown or loosely typed data at boundaries with Effect Schema, named guards, or typed adapters. Use when lint flags double casts, inline object assertions, unknown shape probing, or ad hoc property checks on unknown values.
    4.3k repo stars
  39. ▌
    Wrdn Effect Raw Fetch Boundary · usefulsoftwareco
    Route HTTP through Effect boundaries instead of raw fetch. Use when lint flags executor/no-raw-fetch or when adding networked protocol/provider code.
    4.3k repo stars
  40. ▌
    Wrdn Effect Atom Reactivity Keys · usefulsoftwareco
    Add reactivityKeys to effect-atom write mutation calls. Use when lint flags a useAtomSet mutation call that mutates data without invalidation keys.
    4.3k repo stars
  41. ▌
    Wrdn Effect Value Inferred Types · usefulsoftwareco
    Replace duplicated object API types with types inferred from the runtime value or factory that owns the shape. Use when lint or review flags an interface/type alias that mirrors a returned object such as a plugin extension, client surface, route map, or handler table.
    4.3k repo stars
  42. ▌
    Wrdn Effect Schema Inferred Types · usefulsoftwareco
    Replace duplicated TypeScript shape declarations next to Effect Schema definitions with schema-derived types. Use when lint or review flags an interface/type alias that repeats fields already described by a nearby Schema.Struct, Schema.Union, Schema.TaggedStruct, or other Effect Schema model.
    4.3k repo stars
  43. ▌
    Integrations Sh · usefulsoftwareco bundle
    Use the `integrations` CLI to find how to integrate with any service — its APIs, MCP servers, GraphQL endpoints, and CLIs, each mapped to the credentials it needs. Use when connecting an agent or app to a third-party service, choosing between integration surfaces, or working out what auth a service requires and where to mint it.
    4.3k repo stars