Skip to content

AGI-comming/functional-skill-creator / skills/fskill-creator/sub-skills/migrate

fskill-creator-migrate

Verified

Migrate lane for fskill-creator; analyzes a legacy skill directory into behavior map, function split proposal, and source evidence.

functions/load_legacy_skill.md

View on GitHub
# load_legacy_skill

## Purpose

Load and normalize a legacy skill directory for migration analysis.

## Input

| Field | Required | Description |
|---|---:|---|
| `legacy_skill_dir` | no | Path to the legacy skill directory containing `SKILL.md`. |
| `legacy_skill_path` | no | Deprecated alias for `legacy_skill_dir`; may also be a direct path to `SKILL.md`. |
| `legacy_skill_content` | no | Raw markdown content provided when the directory is unavailable. |

## Output

| Field | Description |
|---|---|
| `legacy_skill.source` | `directory`, `path`, or `content`. |
| `legacy_skill.skill_root` | Resolved legacy skill directory when available. |
| `legacy_skill.path` | Path to `SKILL.md` when loaded from disk. |
| `legacy_skill.markdown` | Normalized `SKILL.md` content. |
| `legacy_skill.sections` | Parsed markdown sections and heading levels from `SKILL.md`. |
| `legacy_skill.metadata` | Frontmatter or inferred name/description. |
| `legacy_skill.companion_files` | Inventory of `references/`, `scripts/`, `tools/`, and `testcases/` under the skill root. |
| `legacy_skill.companion_contents` | Loaded markdown from `references/*.md` when available. |
| `legacy_skill.warnings` | Loading or normalization warnings. |

## Logic

1. Resolve `legacy_skill_dir` from `legacy_skill_dir`, `legacy_skill_path`, or the parent directory of a direct `SKILL.md` path.
2. When both directory and `legacy_skill_content` are provided, prioritize the directory and load `SKILL.md` from disk.
3. Read `SKILL.md` from the resolved skill root; inventory companion files under `references/`, `scripts/`, `tools/`, and `testcases/`.
4. Preserve original markdown wording and existing script filenames.
5. Parse headings and frontmatter, but do not rewrite content.
6. Return warnings for missing `SKILL.md`, content that is too short, lacks a title, or lacks a goal.

## Errors

| Code | When |
|---|---|
| `[MISSING_LEGACY_SKILL]` | Neither skill directory nor content provided. |
| `[READ_FAILED]` | Unable to read source directory or `SKILL.md`. |
| `[MISSING_SKILL_MD]` | Skill directory exists but lacks `SKILL.md`. |

## Observability

Record source type, skill root, section count, markdown length, companion file counts, and load warnings.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall