askit-migrate
Purpose
Adopt an existing skills repository into a Standard-conformant plugin. Three modes: assess surveys the repo's components and structure, maps them to the Standard's component types, and reports the conformance gap (what is missing for Bronze, then Silver), handling the pre-library.json state the conformance core cannot yet grade; plan produces an ordered bring-to-conformance roadmap keyed to the tiers and names the askit-build-* skill or check that closes each gap; adopt performs the first structural step by writing a minimal canonical library.json and a root AGENTS.md if absent, so the repo becomes gradeable and the rest of the plan can run through askit-evaluate and the builders. Authoring depth is in references/migration-workflow.md.
When to use
When adopting a foreign or ad-hoc skills repo, migrating a Claude-only plugin toward cross-agent conformance, or planning a Bronze-to-Silver upgrade path for an existing repository.
assess mode
- Discover what exists: skills, commands, subagents, hooks, MCP config, instructions (
AGENTS.md / CLAUDE.md), and any manifest. Map each to a Standard component type (sec 3).
- Report the gap by tier. The Bronze blockers first (a parseable
library.json, a root AGENTS.md, valid skill frontmatter, name-equals-directory, resolvable reference links), then the Silver blockers (agent-targets, the plugin prefix, a components index, native manifests).
- Where a
library.json already exists, delegate the per-rule grading to askit-evaluate; otherwise report the pre-manifest gaps the conformance core cannot yet see and run assess again after adopt.
plan mode
- Order the gaps into a staged roadmap: Bronze first (make it parse and self-describe), then Silver (cross-agent shape and the prefix), then the optional tail (hooks, workflows, docs site).
- For each step name the resolver: the
askit-build-* skill that authors the component, the check whose message states the fix, or askit-evaluate to re-confirm.
- Record the plan so the migration is legible and resumable across sessions.
adopt mode
- Write the Bronze-minimal canonical
library.json the conformance core requires at every tier (sec 5.1, check U1): name, version 0.1.0, description, standard (the Standard version targeted), and tier universal. That is the smallest manifest that satisfies U1 and makes the repo gradeable.
- Add a root
AGENTS.md if absent (Standard sec 3.10) so anatomy (U2) passes, then run askit-evaluate to confirm Bronze is clean.
- When climbing to Silver, add the Convergent-only fields the higher checks require:
agent-targets (S1), a kebab-case prefix ending in a hyphen carried by every component name (S2), and a components index (S3); then emit native manifests with node scripts/generators/gen-manifest.mjs . --write --target=all (S6) and hand off to the askit-build-* skills and askit-evaluate.
Scope
askit-migrate adopts an existing repo; greenfield scaffolding from an interview is a separate, planned init/onboarding flow (Standard sec 10.7). It makes the repo gradeable and produces the plan, then the askit-build-* skills and askit-evaluate execute the plan slice by slice; it does not rename components to add the prefix wholesale or rewrite skills on its own. The why-gate applies before adding any new component (see askit-backlog).
1---2name: askit-migrate3description: Assesses an existing skills repository against the Advanced Skill Library Standard, produces a staged bring-to-conformance plan, and writes the minimal canonical manifest so the repo becomes gradeable. Use when adopting a foreign or ad-hoc skills repo, migrating a Claude-only plugin toward cross-agent conformance, or planning a Bronze-to-Silver upgrade path.4---56# askit-migrate78## Purpose9Adopt an existing skills repository into a Standard-conformant plugin. Three modes: `assess` surveys the repo's components and structure, maps them to the Standard's component types, and reports the conformance gap (what is missing for Bronze, then Silver), handling the pre-`library.json` state the conformance core cannot yet grade; `plan` produces an ordered bring-to-conformance roadmap keyed to the tiers and names the `askit-build-*` skill or check that closes each gap; `adopt` performs the first structural step by writing a minimal canonical `library.json` and a root `AGENTS.md` if absent, so the repo becomes gradeable and the rest of the plan can run through `askit-evaluate` and the builders. Authoring depth is in [references/migration-workflow.md](references/migration-workflow.md).1011## When to use12When adopting a foreign or ad-hoc skills repo, migrating a Claude-only plugin toward cross-agent conformance, or planning a Bronze-to-Silver upgrade path for an existing repository.1314## assess mode151. Discover what exists: skills, commands, subagents, hooks, MCP config, instructions (`AGENTS.md` / `CLAUDE.md`), and any manifest. Map each to a Standard component type (sec 3).162. Report the gap by tier. The Bronze blockers first (a parseable `library.json`, a root `AGENTS.md`, valid skill frontmatter, name-equals-directory, resolvable reference links), then the Silver blockers (`agent-targets`, the plugin prefix, a `components` index, native manifests).173. Where a `library.json` already exists, delegate the per-rule grading to `askit-evaluate`; otherwise report the pre-manifest gaps the conformance core cannot yet see and run `assess` again after `adopt`.1819## plan mode201. Order the gaps into a staged roadmap: Bronze first (make it parse and self-describe), then Silver (cross-agent shape and the prefix), then the optional tail (hooks, workflows, docs site).212. For each step name the resolver: the `askit-build-*` skill that authors the component, the check whose message states the fix, or `askit-evaluate` to re-confirm.223. Record the plan so the migration is legible and resumable across sessions.2324## adopt mode251. Write the Bronze-minimal canonical `library.json` the conformance core requires at every tier (sec 5.1, check U1): `name`, `version` 0.1.0, `description`, `standard` (the Standard version targeted), and `tier` `universal`. That is the smallest manifest that satisfies U1 and makes the repo gradeable.262. Add a root `AGENTS.md` if absent (Standard sec 3.10) so anatomy (U2) passes, then run `askit-evaluate` to confirm Bronze is clean.273. When climbing to Silver, add the Convergent-only fields the higher checks require: `agent-targets` (S1), a kebab-case `prefix` ending in a hyphen carried by every component name (S2), and a `components` index (S3); then emit native manifests with `node scripts/generators/gen-manifest.mjs . --write --target=all` (S6) and hand off to the `askit-build-*` skills and `askit-evaluate`.2829## Scope30`askit-migrate` adopts an existing repo; greenfield scaffolding from an interview is a separate, planned init/onboarding flow (Standard sec 10.7). It makes the repo gradeable and produces the plan, then the `askit-build-*` skills and `askit-evaluate` execute the plan slice by slice; it does not rename components to add the prefix wholesale or rewrite skills on its own. The why-gate applies before adding any new component (see `askit-backlog`).
product-on-purpose