Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

mindtickle-sdk-patterns

/mindtickle-sdk-patterns

Buduje typowany adapter Mindtickle dla tenantu z autoryzowanych przez klienta artefaktów API, bez zakładania publicznego SDK, dla dostępu do API Content, User i Reporting.

Licencja
MIT
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
2
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Buduje typowany adapter Mindtickle dla tenantu z autoryzowanych przez klienta artefaktów API, bez zakładania publicznego SDK, dla dostępu do API Content, User i Reporting.

Wyzwalacze z opisu

design a Mindtickle adapter

Argumenty

/mindtickle-sdk-patterns [contract-path] [language]
Oryginalny opis (EN)

Build a typed, tenant-scoped Mindtickle adapter from customer-authorized API artifacts without assuming a public SDK. Use when implementing Content, User, or Reporting API access. Trigger with "design a Mindtickle adapter".

Jak działa

  1. Overview
  2. Prerequisites
  3. Tool Discipline
  4. Current Contract
  5. Authentication
  6. Instructions
  7. Approval Boundaries
  8. Output
  9. Error Handling
  10. Example
Sekcje z nagłówków SKILL.md, w oryginale · 66 linii, 447 słów
Podgląd SKILL.md
---
name: mindtickle-sdk-patterns
description: 'Build a typed, tenant-scoped Mindtickle adapter from customer-authorized API artifacts without assuming a public SDK. Use when implementing Content, User, or Reporting API access. Trigger with "design a Mindtickle adapter".'
argument-hint: "[contract-path] [language]"
allowed-tools: Read, Glob, Grep, WebFetch, Write, Edit
version: 1.8.0
author: Jeremy Longshore <jeremy@intentsolutions.io>
license: MIT
tags: [saas, mindtickle, api, adapter, contract-testing]
model: inherit
effort: high
compatibility: Designed for Claude Code; API artifacts and credentials must be supplied by an authorized customer or Mindtickle representative
---
# Contract-First Mindtickle Adapter Patterns

## Overview

Turn an authorized tenant API contract into a narrow adapter with explicit operations, validation, retries, tenancy, and evidence—without fabricating an SDK or route.

## Prerequisites

- A versioned tenant API artifact with provenance, permitted operations, and data classification
- Confirmed authentication, environment, capacity, support, and change-notification contracts
- Test fixtures that contain no production secrets or learner PII

## Tool Discipline

Use `Read`, `Glob`, and `Grep` to inspect contract artifacts and code, `WebFetch` only for authorized current documentation, and `Write` or `Edit` for adapter code, fixtures, and redacted receipts.

## Current Contract

Public Mindtickle material confirms REST-based Content, User, and Reporting APIs but does not define a universal public SDK, base URL, route set, or credential header. Treat the tenant artifact as the executable authority and record its digest and expiry.

## Authentication

Inject credentials through the approved runtime secret provider. Bind configuration to one tenant and environment, redact request logs, and reject startup when tenant, host, or credential provenance is ambiguous.

## Instructions

1. Inventory only documented operations needed for the business workflow and classify each read, write, idempotency, and privacy property.
2. Freeze the source artifact digest, tenant, environment, auth scheme, schemas, pagination, errors, and capacity signals.
3. Generate or handwrite internal transport types behind a product-specific interface; never leak vendor payloads into domain logic.
4. Validate requests and responses at the boundary and reject undocumented fields or status assumptions.
5. Implement bounded retries only for documented transient conditions, with idempotency or reconciliation for writes.
6. Add fixtures for success, authorization failure, validation failure, pagination, throttling signals, timeout ambiguity, and schema drift.
7. Produce a mutation preview and require approval before the first tenant write.
8. Capture contract digest, test results, deployed adapter version, and rollback compatibility.

## Approval Boundaries

Do not reverse engineer tenant traffic, scrape the authenticated UI, publish confidential API artifacts, add undocumented operations, or run writes without resource-owner approval.

## Output

Return the contract inventory and digest, adapter boundary, auth and tenant controls, fixture coverage, retry/reconciliation policy, mutation preview, and rollback plan.

## Error Handling

| Condition | Response |
|---|---|
| Runtime response violates the contract | Quarantine the payload, stop writes, and open a contract clarification. |
| Write times out ambiguously | Reconcile through a documented read or support receipt before retrying. |
| Only marketing documentation exists | Produce an interface proposal and vendor questions; do not implement network calls. |

## Example

```text
contract-sha256=...; tenant-bound=true; operations=3-read,1-write; fixtures=7-pass; first-write=approval-required
```

## Resources

- [Mindtickle integrations and API families](https://www.mindtickle.com/platform/integrations/)
- [Professional services scope](https://www.mindtickle.com/legal/professional-services-scope-and-services-description/)

## Next Steps

Wire the frozen contract fixtures into CI and rehearse rollback against the previous adapter version.

Wersje

W bazie nie ma innych skilli o nazwie mindtickle-sdk-patterns.

Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

Migawka bazy z 13.11.2026 · wersja paczki 37ae5cba81f7 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100mindtickle-hello-world
    Odkrywa licencjonowane możliwości tenanta Mindtickle i przygotowuje bezpieczny pierwszy dowód integracji bez zakładania szczegółów publicznego API.
  • 100workhuman-sdk-patterns
    Projektuje typowany adapter integracji Workhuman na podstawie autoryzowanych przez klienta kontraktów API lub konektorów, bez zakładania publicznego SDK.
  • 100ship-adapter
    Przenosi schematy, interfejsy i kontrakty API do adapterów: adapter bazy, klienta API lub transformatora danych.
  • 96s04-06-api-client-wrapper
    Zamienia endpointy API na typowany zestaw funkcji dla frontendu i mini programu, czyli SDK z definicjami typów.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.