mindtickle-performance-tuning

v2026.09.24

Diagnose and improve a Mindtickle integration with measured latency, backlog, freshness, and reconciliation evidence. Use when reports or syncs miss objectives. Trigger with "tune Mindtickle performance".

GitHub
Install command
npx skhub add jeremylongshore/mindtickle-performance-tuning
Markdown
SKILL.md

Evidence-Driven Mindtickle Integration Performance

Overview

Improve the customer-controlled integration path from a reproducible baseline while respecting tenant contracts, privacy, freshness, and correctness.

Prerequisites

  • A service-level objective, representative workload, current contract digest, and observation window
  • Metrics for latency, attempts, errors, retries, backlog age, throughput, freshness, and reconciliation
  • A non-production load path or approved canary with explicit abort thresholds

Tool Discipline

Use Read, Glob, and Grep to inspect traces and configuration, WebFetch for current authorized contracts, and Write or Edit for benchmarks, controlled changes, tests, and redacted receipts.

Current Contract

Performance spans the customer application, network, identity, adapter, tenant operations, and downstream systems. Mindtickle states support for scalable integrations but does not publish universal latency or quota targets, so customer objectives and tenant-specific evidence must remain separate.

Authentication

Benchmark with synthetic or aggregate data and a least-privilege non-production principal. Never use extra credentials to create artificial concurrency or include payload contents in traces.

Instructions

  1. Define the user or business symptom, objective, correctness invariant, workload, and baseline window.
  2. Break elapsed time into queue, customer processing, network, tenant response, downstream processing, and reconciliation.
  3. Segment by operation, page or batch, payload class, tenant, response class, and time without exposing personal data.
  4. Rank bottlenecks by measured contribution and distinguish latency from throttling, backlog, and data-quality delay.
  5. Propose one controlled change at a time: scheduling, bounded concurrency, pagination, batching, caching, indexing, or payload reduction only where the contract permits it.
  6. Define cache ownership, freshness, invalidation, privacy, and stale-data behavior before enabling a cache.
  7. Run the experiment within abort thresholds and compare p50, tail latency, errors, retries, backlog, freshness, and reconciliation.
  8. Retain the change only when the improvement is repeatable and correctness is unchanged; otherwise roll back.

Approval Boundaries

Do not load-test production, raise concurrency, retain learner data in a cache, or trade correctness for speed without explicit owners.

Output

Return the objective, baseline, bottleneck evidence, experiment, approvals, before-and-after metrics, correctness reconciliation, decision, and rollback receipt.

Error Handling

ConditionResponse
Metrics omit queue or retry timeRepair instrumentation before claiming improvement.
Vendor behavior changes during a testStop, preserve the window, and rerun after the contract is stable.
Faster run produces divergent dataRoll back immediately and investigate correctness first.

Example

objective=freshness-under-target; baseline=7d; bottleneck=customer-queue; change=schedule-partition; tail-latency=improved; reconciliation=exact

Resources

Next Steps

Observe the retained change for a full workload cycle and update the capacity policy with measured evidence.

Discovery
Tags

No tags published for this skill.

Version
Latest version metadata

Version

v2026.09.24

Published

Sep 24, 2026

Category

Uncategorized

License

MIT

Source path

skills/.curated/mindtickle-performance-tuning

Default branch

main

Latest commit

e5a6c3b

Tree SHA

c2dc8e8