Skip to content

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

fskill-creator-migrate

Unverified

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

fskill-creator-migrate

Goal

Analyze a large or hard-to-maintain legacy skill directory into structured migration context while preserving behavior. This sub-skill only performs migration pre-analysis and does not directly write final functional skill files; final artifact generation, runtime capability provisioning, file writing, and validation are handled by the main fskill-creator.

Invoked by the main skill when the user has an existing monolithic skill and wants to "refactor into functional", "migrate to functional skill", or "restructure into functions/references/scripts".

Principles

  • Preserve existing behavior first, then optimize structure.
  • Load the whole legacy skill package, not only SKILL.md.
  • Keep source section and file evidence so reviewers can trace migrated content.
  • Only output migration_context; must not directly write target skill files.
  • Duplicated rules, schemas, and vocabulary move to reference_plan.
  • Existing references/, scripts/, and tools/ are inventoried before proposing splits.
  • Deterministic parsing, formatting, validation, or mechanical transforms are identified as script_plan, to be generated or preserved later by the main skill.
  • Optional viewers only enter tool_plan; final files are generated uniformly by the main skill's add_runtime_capabilities.

References

ResourceLoad TimingPurpose
shared_glossaryOn demandStable migration terminology and output fields.
script_rulesBefore proposing scriptsRules for deciding what belongs in scripts/.

External Inputs

FieldSourceDescription
legacy_skill_diruser or repositoryPath to the legacy skill directory containing SKILL.md.
legacy_skill_pathuser or repositoryDeprecated alias for legacy_skill_dir; may also be a direct path to SKILL.md, which resolves to its parent directory.
legacy_skill_contentuser or repositoryExisting skill markdown content when the directory is inaccessible.
migration_constraintsuserConstraints such as preserving file names, tone, or platform rules.
known_testcasesuser or repositoryExisting examples, traces, or expected behaviors.
existing_scriptsrepositoryExisting helper scripts associated with the legacy skill.
include_viewersuserWhether to suggest generating tools/log_viewer.mjs and tools/tester_viewer.mjs.
script_runtimeenvironmentWhether this sub-skill's own Node.js scripts can be run.

Execution Pipeline

StepFunctionPurposeInputOutput
1load_legacy_skillLoad and normalize the legacy skill package.legacy_skill_dirlegacy_skill_pathlegacy_skill_contentlegacy_skill
2map_existing_behaviorIdentify goals, rules, inputs, outputs, and behaviors that must be preserved.legacy_skillmigration_constraintsbehavior_map
3propose_function_splitPropose function boundaries, script opportunities, optional viewer tools, and target file layout.legacy_skillbehavior_mapscript_rulesinclude_viewersscript_runtimemigration_proposalscript_plantool_plan
4extract_shared_referencesMove duplicated or shared rules into references.legacy_skillmigration_proposalscript_planreference_plan

Output

The main skill combines the above outputs into:

FieldDescription
migration_context.legacy_skillLoaded source skill package data.
migration_context.behavior_mapBehaviors that must be preserved.
migration_context.migration_proposalFunction split and target structure proposal.
migration_context.reference_planTerms, rules, and schemas that should go into shared references.
migration_context.script_planDeterministic helpers to generate, preserve, or refactor.
migration_context.tool_planOptional viewer choices.
migration_context.source_evidenceLegacy source sections, companion files, and behavior preservation evidence.

Output Scope

Only output migration context; must not directly write target skill files or delete the legacy skill.

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: 464kUpdated Claude CodeCodexVerifiedInstall
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: 464kUpdated 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: 318kUpdated Claude CodeCodexUnverifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 318kUpdated Claude CodeCodexUnverifiedInstall