Okhp3 Gpt Skill Conversion Plan

---
name: okhp3-gpt-skill-conversion-plan
description: >-
  Plan conversion of an existing Custom GPT into a portable Agent Skill. Use
  when a GPT already has instructions, knowledge files, actions, conversation
  starters, test prompts, or usage history and the user needs a capability map,
  semantic-loss analysis, reusable skill boundary, migration plan, or handoff
  to okhp3-skill-foundry.
license: MIT
metadata:
  version: "1.2.0"
  author: "OverKill Hill P³"
  category: universal
  origin: okhp3/skillz
  homepage: https://overkillhill.com
  author-github: https://github.com/OKHP3
  in_scope: "Capability mapping, semantic-loss analysis, and migration planning from an existing Custom GPT to a portable Agent Skill."
  out_of_scope: "Exporting private platform data, bypassing permissions, implementing production integrations, or claiming unverified feature parity."
---

# okhp3-gpt-skill-conversion-plan

**OverKill Hill P³** · [overkillhill.com](https://overkillhill.com) · [github.com/OKHP3](https://github.com/OKHP3)

Convert a configured GPT into a durable, runtime-portable skill plan without
pretending that GPT configuration and Agent Skill instructions are equivalent.
This skill plans and audits the conversion; `okhp3-skill-foundry` authors and
benchmarks the final SKILL.md.

## Scope

| In scope | Out of scope |
|---|---|
| Asset inventory, capability mapping, boundary design, portability analysis, semantic-loss tracking, migration sequencing, and Foundry handoff | Exporting private platform data, bypassing permissions, writing production integrations, or claiming feature parity without verification |

## Conversion method

1. **Collect the source package.** Inventory GPT name and purpose, instructions, knowledge files, actions/apps, starters, examples, eval prompts, user feedback, platform assumptions, version history, and any prompt-chain stages with their outputs. Mark each item `available`, `partial`, `missing`, or `unverified` and label its claim class.
2. **Map semantics, not wording.** For each source behavior record its skill equivalent: trigger description, imperative procedure, reference, script, output contract, safety rule, or unresolved platform dependency. Convert a useful chain stage into a named procedure with inputs, observable exit criteria, and a recovery path. Preserve intent while removing UI-only language. Treat a claimed behavior as unproven until an example, preview result, or evaluation demonstrates it.
3. **Separate portable from platform-bound behavior.** Keep reasoning patterns, schemas, rubrics, and public references in the skill. Isolate Builder toggles, ChatGPT-only UI, proprietary connectors, credentials, and undocumented model behavior as adapters or explicit exclusions.
4. **Detect semantic loss.** Identify capabilities that cannot transfer cleanly: retrieval ranking, hidden system behavior, tool auth, connector permissions, conversation memory, model-specific formatting, and publishing controls. For each, state impact and a mitigation or acceptance test.
5. **Design the skill boundary.** Define trigger phrases, in-scope and out-of-scope work, required inputs, outputs, escalation rules, references, scripts, assets, and version ownership. Avoid cloning an entire GPT when a smaller composable skill is more reliable. Record how the source hierarchy, tool policy, and failure handling will survive the move.
6. **Create a migration backlog.** Order work as `preserve`, `rewrite`, `externalize`, `replace`, `verify`, or `drop`. Assign acceptance criteria and dependencies. Never carry secrets or private data into a public skill.
7. **Plan Foundry validation.** Propose exactly three distinct eval cases with four evidence-anchored expectations each. Include one semantic-preservation case, one platform-bound loss or adapter case, and one boundary or safety case when applicable. The Foundry should later run with-skill and without-skill comparisons, grade evidence, compute the delta, and iterate.
8. **Issue a disposition:** `ready_for_foundry`, `needs_source_artifacts`, `partial_port`, `not_a_skill`, or `blocked_by_permissions`. Explain what must happen next.

## Required output

Return these sections in order:

1. **Conversion verdict** with disposition, portability confidence, semantic-loss risk, and blockers.
2. **Source inventory** table with `asset`, `status`, `portable_value`, `destination`, and `evidence`.
3. **Capability map** linking each GPT behavior to a skill construct or adapter.
4. **Semantic-loss register** with impact, mitigation, and test.
5. **Skill architecture** covering trigger, scope, workflow, outputs, safety, references, scripts, and ownership.
6. **Migration backlog** with ordered actions and acceptance criteria.
7. **Foundry handoff** using `references/conversion-dossier-schema.md`.

Use public-safe or synthetic examples. Treat unknown platform behavior as
`unverified`; do not invent an export format or claim that hidden GPT behavior
can be reproduced in a SKILL.md.

## Quality gates

- Every source capability has a destination, an explicit drop decision, or a blocker.
- Every proposed portable behavior has evidence, an explicit theory label, or a validation task.
- Platform-bound features are isolated from portable method content.
- Semantic loss is explicit and paired with a mitigation or eval.
- The proposed skill is smaller and composable where possible.
- Prompt-chain control language is converted into modular procedures or explicitly dropped; it is never copied as irreversible runtime instruction.
- Eval expectations test facts supplied by the skill, not generic competence.
- The handoff tells `okhp3-skill-foundry` exactly what to build and measure.

## Handoff

Read `references/conversion-dossier-schema.md` before producing a machine-readable dossier. Use `evals/evals.json` to calibrate eval design. When the verdict is `ready_for_foundry`, load `okhp3-skill-foundry` for architecture, drafting, live evaluation, grading, benchmarking, and fix loops.

## About

Built by [Jamie Hill](https://overkillhill.com) · [OverKill Hill P³](https://overkillhill.com)
Published at [github.com/OKHP3](https://github.com/OKHP3)
Part of the [OKHP3/skillz](https://github.com/OKHP3/skillz) Agent Skill library.
MIT License -- free to use, fork, and adapt. A nod to the source is appreciated.