migration-guide SKILL.md skillA

migration-guide from lingtai-ai/lingtai-kernel is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add lingtai-ai/lingtai-kernel/migration-guide@v2.3.0

Pins v2.3.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
lingtai-ai/lingtai-kernel
Path
src/lingtai/intrinsic_skills/system-manual/reference/migration-guide/SKILL.md
Versions recorded
4
Latest version
v2.3.0, committed Sep 15, 2026
First version recorded
Sep 14, 2026
Size
7,531 bytes
Repository stars
11
License
Apache-2.0

Conclusion-first router for authorizing, selecting, recovering, and proving a mechanical Agent workdir/address or whole-Project path move.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Migration Guide — Agent and Project Path Relocation

**Conclusion:** classify the request, prove exact current authority, pass every
common gate, choose one lane, and then read only that lane's reference. This
router and its helpers grant no authority. `HOLD` on any missing, stale,
ambiguous, or broader-than-written fact.

## 1. Classify

| Request | Route |
|---|---|
| Mutable display nickname (`name_nickname`) | System identity action; no path move. |
| One-time immutable true name (`name_set`) | System identity action; no path move. |
| One Agent workdir/derived address or a whole Project path | Continue here; immutable identity does not thereby change. |
| Source, interpreter, venv, install provenance, or selector change | [`runtime-update-checks`](../runtime-update-checks/SKILL.md), then [`refresh-precheck`](../refresh-precheck/SKILL.md) only for a separately authorized refresh. |

A Project-root move normally preserves every Agent's identity, true name, and
basename address. Inventory affected owners' stale references without inferring
permission to rewrite them.

## 2. Prove authority

Before every attempt, record current human-owner authority for:
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add lingtai-ai/lingtai-kernel/migration-guide@sha256:4fd050bafda01be0

The line at the top of this page pins the label v2.3.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_oj6cenzh6aev5l3y.svg)](https://markdownregistry.com/a/art_oj6cenzh6aev5l3y)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, between Sep 14, 2026 and Sep 15, 2026, more than one a day.

versioncommittedcommitsizeaudit
v2.3.0 latest2026-09-15 199abd6 7,531 BA view · diff
v2.2.72026-09-15 6c16463 18,707 BA view · diff
v2.2.42026-09-14 dfe8ba2 14,113 BA view · diff
v2.0.02026-09-14 7f81f68 8,608 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (7531 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

lingtai-ai/lingtai-kernel · 11 stars · license Apache-2.0 · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_oj6cenzh6aev5l3y
GET https://markdownregistry.com/api/v1/resolve?ref=lingtai-ai/lingtai-kernel/migration-guide
GET https://markdownregistry.com/api/v1/blob/4fd050bafda01be03e4b3cd10f9b2f8820e21264cdc51dfea42bd3bce7285894

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from lingtai-ai/lingtai-kernel

AGENTS.md AGENTS.md file
lingtai-ai/lingtai-kernel · AGENTS.md
git:20260915.6a7c067 · audit A · 11 stars
CLAUDE.md CLAUDE.md file
lingtai-ai/lingtai-kernel · CLAUDE.md
git:20260714.b410ffc · audit A · 11 stars
lingtai-kernel-dev SKILL.md skill
lingtai-ai/lingtai-kernel · dev-guide-skill/SKILL.md · Mandatory repository-local development guide for LingTai's Python kernel and runtime. Use this before changing code…
git:20260810.a0f7998 · audit A · 11 stars
hello-lingtai SKILL.md skill
lingtai-ai/lingtai-kernel · docs/examples/agent-plugins/hello-lingtai/skills/hello-lingtai/SKILL.md · The example Agent Plugin's one skill. Reach for it only to confirm that plugin registration worked: if this skill is in…
v1.0.0 · audit A · 11 stars
lingtai-doctor SKILL.md skill
lingtai-ai/lingtai-kernel · src/lingtai/intrinsic_skills/lingtai-doctor/SKILL.md · Read-only health diagnostics when an agent looks dead but the evidence is mixed, or a migration may have left stale…
v0.2.0 · audit A · 11 stars
lingtai-kernel-anatomy SKILL.md skill
lingtai-ai/lingtai-kernel · src/lingtai/intrinsic_skills/lingtai-kernel-anatomy/SKILL.md · Enter the Python kernel Anatomy/Contract graph before source navigation or maintaining architecture maps; explains how…
v0.5.0 · audit A · 11 stars
lingtai-manual SKILL.md skill
lingtai-ai/lingtai-kernel · src/lingtai/intrinsic_skills/lingtai-manual/SKILL.md · Retirement reference for legacy character memory; use unified Pad and Knowledge.
v2.1.0 · audit A · 11 stars
lingtai-recipe SKILL.md skill
lingtai-ai/lingtai-kernel · src/lingtai/intrinsic_skills/lingtai-recipe/SKILL.md · Menu manual (not a tool) for recipes — the named payload that shapes an orchestrator's greeting, ongoing behaviour, and…
v3.3.0 · audit A · 11 stars
recipe-export-flow SKILL.md skill
lingtai-ai/lingtai-kernel · src/lingtai/intrinsic_skills/lingtai-recipe/reference/export-recipe/SKILL.md · Nested lingtai-recipe reference for exporting a standalone recipe bundle from a live network or methodology: scope…
v1.1.0 · audit A · 11 stars
recipe-format-reference SKILL.md skill
lingtai-ai/lingtai-kernel · src/lingtai/intrinsic_skills/lingtai-recipe/reference/recipe-format/SKILL.md · Nested lingtai-recipe reference for authoring and validating recipe bundles: bundle structure, .recipe/recipe.json…
v1.1.0 · audit A · 11 stars
pad-manual SKILL.md skill
lingtai-ai/lingtai-kernel · src/lingtai/intrinsic_skills/pad-manual/SKILL.md · Read before editing the living Pad, pinning references, or preparing Pad state for rebuild/molt.
v2.1.0 · audit A · 11 stars
psyche-manual SKILL.md skill
lingtai-ai/lingtai-kernel · src/lingtai/intrinsic_skills/psyche-manual/SKILL.md · Compact router for Psyche's private-memory and procedure domains (pad, knowledge, skills), the shared file→rebuild…
git:20261017.6531f09 · audit A · 11 stars

Every file in lingtai-ai/lingtai-kernel

Browse by kind, by grade A, or by owner.