1---2name: x-twitter-migration-assistant3description: Use when tasks require x twitter migration assistant with credential-aware preflight, deterministic execution, validation gates, and handoff-ready artifacts.4---56# X Twitter Migration Assistant78## Quick Reference9| Field | Value |10| --- | --- |11| Skill ID | `780` |12| Provider | `X Twitter` |13| Operation | `Migration Assistant` |14| Domain | `External SaaS integrations` |15| Runtime archetype | `migration-engine` |16| Core method | `staged migration planning and cutover` |17| Primary artifact | `x-twitter-migration-cutover-plan` |18| Routing tag | `x-twitter:migration-assistant` |19| Mutating | `yes` |20| Release cycles | `3` |2122## Why This Skill Exists23We need this skill because X Twitter workflows degrade when state changes are hard to undo once they begin. This specific skill turns X Twitter Migration Assistant into a deterministic, auth-checked workflow for plans and executes safe migrations to or from x twitter..2425## Trigger Checklist26- [ ] The task explicitly requires `X Twitter Migration Assistant` rather than generic brainstorming.27- [ ] The provider tenant, workspace, or environment is known before execution begins.28- [ ] Credential reuse has been checked before asking for new secrets.29- [ ] Success criteria, side effects, and handoff owner are clear.30- [ ] If the run mutates provider state, the relevant approval gates are available.3132## Auth & Access Profile33| Field | Value |34| --- | --- |35| External auth required | `yes` |36| API key likely required | `no` |37| Protocols | `HTTPS/REST` |38| Mutating | `yes` |39| Webhook capable | `no` |4041| Auth Mode | Kind | Env Hints | Validation |42| --- | --- | --- | --- |43| OAuth client or delegated session | `oauth2` | `X_TWITTER_CLIENT_ID`, `X_TWITTER_CLIENT_SECRET` | Reuse an active delegated session or validate the client credentials with a lightweight identity call. |44| Access token or personal access token | `token` | `X_TWITTER_TOKEN`, `X_TWITTER_ACCESS_TOKEN` | Validate the token with the smallest read-only endpoint that proves scope and tenancy. |4546## Inputs (contract)47| Input | Type | Required | Source |48| --- | --- | --- | --- |49| source inventory | signal | yes | operator or upstream tool |50| target mapping | signal | yes | operator or upstream tool |51| rollback plan | signal | yes | operator or upstream tool |5253## Outputs (contract)54| Output | Type | Guaranteed | Consumer |55| --- | --- | --- | --- |56| x-twitter-migration-cutover-plan | structured-artifact | yes | next workflow or operator |57| x-twitter-migration-cutover-plan-scorecard | scorecard | yes | reviewer |58| x-twitter-migration-cutover-plan-handoff | handoff-packet | yes | downstream owner |5960## Step-by-Step Implementation Guide611. Define the source inventory, target mapping, cutover window, and rollback checkpoint for X Twitter Migration Assistant before any X Twitter rehearsal is approved.622. Validate credential reuse, export baselines, and the human approval chain for every irreversible migration step.633. Implement plans and executes safe migrations to or from x twitter. as staged rehearsal, checkpoint, and cutover workflows that preserve a deterministic revert path.644. Capture migration inventories, mapping diffs, checkpoint identifiers, and partial-failure evidence in the cutover plan.655. Run simulation and regression suites that cover missing inventory, rollback weakness, and partial cutover outcomes.666. Publish a migration cutover plan with rehearsal status, rollback readiness, and the exact approval still required for production execution.6768## Operational Runbook69### Preflight70- Validate the full source inventory, target mapping, cutover window, and rollback checkpoint before rehearsal begins.71- Require an explicit human approval path for every irreversible step in the migration.7273### Execution74- Rehearse the migration with deterministic checkpoints before the production cutover is allowed.75- Pause on any unapproved mapping gap or rollback weakness rather than proceeding optimistically.7677### Recovery78- Abort cutover immediately when checkpoints or rollback evidence fail validation.79- Revert to the last stable platform state and capture every partially migrated object for review.8081### Handoff82- Return the migration cutover plan, rehearsal results, and rollback status.83- State clearly whether the migration is ready, blocked, partially rolled back, or awaiting approval.8485## Validation Gates & Test Matrix86| Gate | Purpose | On Fail |87| --- | --- | --- |88| auth-preflight | Validate credential presence, scope, and environment before work begins. | block execution |89| schema-contract-check | Ensure required signals and payload shapes remain valid. | quarantine and request correction |90| policy-approval-check | Verify the declared approval gates before mutating or publishing state. | pause or route to human review |91| reliability-check | Confirm retries, rollback, and checkpoint readiness. | rollback or fail closed |9293- Required validation suites: `unit`, `integration`, `simulation`, `regression-baseline`9495## Failure Modes & Recovery Playbook96| Code | Trigger | Action |97| --- | --- | --- |98| `E_INVENTORY_GAP` | The source inventory is incomplete or inconsistent with the target mapping. | Block rehearsal and request a corrected inventory or mapping diff. |99| `E_ROLLBACK_WEAKNESS` | Rollback checkpoints are missing or cannot restore all affected entities. | Fail closed and prohibit cutover approval. |100| `E_PARTIAL_CUTOVER` | The cutover succeeds for only a subset of the planned assets. | Abort the migration and revert to the last stable platform state. |101102## Tool Call Implementation103- Reuse existing credentials first. Check environment variables, secure stores, and active sessions before prompting.104- Start with the smallest authenticated read or validation call that proves identity and scope.105- Preserve request, response, and approval traces in `x-twitter-migration-cutover-plan` so downstream owners do not need to rediscover context.106- If any auth, contract, or approval gate fails, halt execution and attach remediation guidance instead of guessing.107108## Credential Reuse Policy109- Reuse valid provider credentials by default and prefer tenant-scoped sessions over newly created secrets.110- Prompt for credentials only when they are missing, invalid, expired, or point at the wrong environment.111- For webhook flows, validate the signing secret against a known sample before accepting live traffic.112113## Guardrails114- safety: Do not permit cutover without a rehearsed rollback checkpoint and explicit approval. (`rollback-readiness-check`)115- quality: Require inventory-to-mapping reconciliation before rehearsal and again before cutover. (`inventory-reconcile`)116- reliability: Abort immediately on partial cutover and revert to the last stable platform state. (`cutover-abort-and-revert`)117118## Acceptance Checklist119- [ ] Credential preflight and scope validation completed successfully.120- [ ] Required validation suites ran and all fail-closed gates passed.121- [ ] x-twitter-migration-cutover-plan, scorecard, and handoff packet were produced.122- [ ] Any mutations, approvals, or rollbacks are reflected in the artifact bundle.123124## Anti-Patterns125- Do not ask for new credentials before checking reusable auth context.126- Do not skip the read-only or dry-run validation step for mutating work.127- Do not proceed when approval gates, signing secrets, or rollback checkpoints are missing.128- Do not hand off partial or ambiguous provider state as complete.129130## Handoff Contract131- **Produces:** `x-twitter-migration-cutover-plan`, execution scorecard, approval trace, and next actions.132- **Consumes:** `source inventory`, `target mapping`, `rollback plan`.133- **Readiness rule:** release only after auth, contract, approval, and reliability gates all pass.134- **Downstream hint:** route to `x-twitter:migration-assistant` consumers with approval and credential context attached.135136## Observability & Continuous Improvement137- SLO: >=99.9% successful runs per 7-day window138- Error budget: <=0.1% critical failures per 7-day window139- Alert triggers:140- credential validation failures exceed baseline141- schema or contract regressions persist for two consecutive runs142- critical posture or rollback events exceed tolerance143- Primary outcome metric: `migration completeness`144- Secondary metrics: `cutover risk`, `rollback success rate`145- Review cadence: `daily`