# HyperTwist - SKILLS.md

## Purpose

This file is the HyperTwist-facing discovery surface for skill families and
skill governance.

It is not a claim that HyperTwist already ships a broad live skill layer.

Use the governing doctrine for rollout, command-surface rules, and off-state
requirements:

- `C:\HyperTwist\docs\ops\HYPERTWIST_SKILLIZATION_AND_COMMAND_SURFACE_DOCTRINE_2026-05-21.md`

Companion doctrines:

- `C:\HyperTwist\docs\ops\HYPERTWIST_OPTIONAL_ASSISTIVE_FEATURE_DEACTIVATION_AND_REMOVABILITY_DOCTRINE_2026-05-21.md`
- `C:\HyperTwist\docs\ops\HYPERTWIST_MEMORY_LANE_AUTHORITY_AND_PHASE_IMPLEMENTATION_DOCTRINE_2026-05-21.md`
- `C:\HyperTwist\docs\ops\HYPERTWIST_PROVIDER_NEUTRALITY_AND_BYOK_DOCTRINE_2026-05-21.md`
- `FEATURE_REGISTRY.md`

## Product rule

Skills are optional assistive layers.

They must:

- sit on top of first-party commands/services
- remain user-deactivatable
- remain removable
- never become the primary truth of a feature

## Current status tiers

Use the feature-registry confidence split here too:

- `Implemented now`
- `Deep-source grounded retained`
- `Shallow placeholder`

Do not present a planned skill family as a shipped skill layer.

## Highest-priority retained skill families

These are retained doctrine-level families, not live implementation claims.

### First-party skill substrate and governance

Status:

- Implemented now, bounded substrate only

Includes:

- landed now:
  - skill registry/manifest contract
  - enable/disable controls
  - visibility grouping
  - invocation record format
  - command/service provenance ledger
  - failure/cancel audit recording
  - command/service binding declarations
  - permission/scope declarations
  - provenance/log declarations
  - authoring template expansion
  - example bundle
  - validation harness

### Analyzer and review skills

Status:

- Implemented now

Includes:

- architecture/repo analysis wrappers
- proposal and diff review helpers
- bounded workflow wrappers

### Memory and continuity skills

Status:

- Deep-source grounded retained with bounded live wrapper

Includes:

- resume/session skills
- recall/search skills
- compact-view skills

### Provider and operations skills

Status:

- Deep-source grounded retained with bounded live wrapper

Includes:

- provider-profile inspection
- BYOK setup
- routing/usage diagnostics

### Domain skill packs

Status:

- Shallow placeholder

Includes:

- replay/training packs
- curriculum packs
- media/export packs

## Core competencies for HyperTwist work

A coding model working on HyperTwist should still be able to:

- inspect simulation engines
- understand move/state notation
- inspect replay and trainer code
- inspect recognition stacks
- reason about progression/coaching systems
- distinguish educational UX from simulation correctness
- propose Unreal-native implementation paths

## Current named endpoint

The browser/docs/design extraction base, browser diagnostics seam, and design
shell seam now exist, the workflow/review family is live, and the bounded
implementation/delegation spec layer is live, and the bounded
plan/orchestration glue layer is now live, and the bounded provider-neutral
profile/routing layer is now live for `inspect-provider-profile`,
`setup-byok-profile`, and `diagnose-provider-routing`. Provider and domain
widening should now reopen through the bounded `S6-B` layer, which is now live
for `audit-provider-usage`, `inspect-provider-topology`, and
`diagnose-route-service`, and then proceed through the now-live `S7-A`
framework layer for `specify-domain-packaging` and
`specify-domain-pack-grouping`, and through the now-live `S7-B` retained layer
for `review-training-replay-pack`, `curate-curriculum-content-pack`, and
`prepare-media-export-pack`, and through the now-live `S7-C` creative/media
adjunct layer for `compose-replay-explainer-pack`,
`prepare-media-parser-pack`, and `curate-shared-fixture-pack`. The current
named first-party skillization ladder is now landed through `S7-C`.
