AugmentClaude

Functional Skill Creator

Create or migrate functional skills from requirements or legacy code.

Installation

  1. Make sure Claude is on your device and in your terminal.

    Skills load from ~/.claude/skills/ when Claude Code starts up — so you need it on your machine first. If you don't have it yet, install it once with the command below, then run claude in any terminal to verify.

    One-time setup
    npm i -g @anthropic-ai/claude-code

    Already have it? Skip ahead.

  2. Paste into Claude Code or into your terminal.

    This copies the whole skill folder into ~/.claude/skills/fskill-creator-shopee-eng/ — the SKILL.md plus any scripts, reference docs, or templates the skill ships with. Safe default: works for every skill.

    Faster alternative (instruction-only skills)

    Skips the clone and grabs only the SKILL.md file. Don't use this if the skill ships Python scripts, reference markdowns, or asset templates — they won't be downloaded and the skill will fail when it tries to load them.

    Quick install (SKILL.md only)
    Sign up to copy
  3. Restart Claude Code.

    Quit and reopen Claude Code (or any other agent that loads from ~/.claude/skills/). New skills are picked up on startup.

  4. Just ask Claude.

    Skills auto-activate when your request matches the skill's description — no slash command needed. Trigger phrases live in the skill's own frontmatter; you can read them in the “What this skill does” section above.

Prefer to read the source first? Open on GitHub.

When Claude uses it

Create, maintain, or migrate functional skills; supports creating from a requirement brief and migrating an existing legacy skill directory into a functional skill structure.

What this skill does

fskill-creator

Goal

Unify the create and migrate lanes to produce a self-contained, reviewable, testable functional agent skill directory. The main skill handles routing, blueprint normalization, shared artifact generation, runtime capability provisioning, file writing, and validation; sub-skills only handle pre-analysis for their respective input forms.

Use this skill when the user wants to "generate a functional skill", "create a functional skill", "add functions to an existing functional skill", or "migrate an existing legacy skill directory into a functional skill".

Principles

  • The main SKILL.md only orchestrates the shared create / migrate / enhance / validate workflow.
  • Create and migrate are two pre-lanes; they must first converge into a unified skill_blueprint.
  • Function-specific behavior lives in functions/*.md; create / migrate specific pre-behavior lives in sub-skills/*/functions/*.md.
  • Shared vocabulary, policies, and schemas live in references/*.md.
  • Deterministic parsing, formatting, validation, and mechanical transforms live in scripts/.
  • Report, unit test, viewer, and testcase capabilities are maintained only once in the main skill, and vendored into the target skill by add_runtime_capabilities.
  • Preserve user-provided domain constraints; the migrate lane must also preserve legacy behavior evidence.
  • When the user has not approved direct modification, generated files should be treated as proposals.

Sub-Skills

Sub-skillWhenResponsibilityOutput
sub-skills/createUser provides a new skill brief or wants to enhance an existing functional skillNormalize requirements, target path, inputs/outputs, constraints, and viewer choicescreate_context
sub-skills/migrateUser provides a legacy skill directory, monolithic skill content, or a migration requestLoad the legacy skill package, identify behaviors that must be preserved, propose function boundaries and evidencemigration_context

Sub-skills do not directly write final target skill files. Their output must go through normalize_skill_blueprint before entering the shared artifact pipeline.

References

ResourceLoad TimingPurpose
shared_glossaryOn demandStable terminology and cross-lane field semantics.
script_rulesBefore designing or drafting scriptsRules for deciding whether deterministic work belongs in scripts/.
sub-skills/createCreate laneForm create_context from user brief.
sub-skills/migrateMigrate laneForm migration_context from a legacy skill directory.

External Inputs

FieldSourceDescription
task_modeuser or derivedcreate, migrate, enhance, or validate; inferred by resolve_task_mode when absent.
skill_requestuserRequirement description for creating or enhancing a skill.
legacy_skill_diruser or repositoryPath to an existing legacy skill directory containing SKILL.md and optional companion files.
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_contentuserLegacy skill markdown provided when the path is inaccessible.
target_skill_pathuser or derivedDirectory where the functional skill should live.
skill_nameuser or derivedOptional target skill name.
existing_skill_filesrepositoryOptional existing functional skill files.
migration_constraintsuserFile names, tone, platform rules, or behaviors that must be preserved during migration.
known_testcasesuser or repositoryExisting examples, traces, or expected behaviors.
existing_scriptsrepositoryHelper scripts associated with the legacy skill.
include_reportuserWhether to generate report log runtime in the target skill; defaults to true.
include_unittestuserWhether to generate unittest / testcase runner in the target skill; defaults to true.
script_runtimeenvironmentWhether this skill's own Node.js scripts can be run.
report_modeuseroff, local, or remote; defaults to off.

Viewers are generated following the capability flags: tools/log_viewer.mjs when include_report=true; tools/tester_viewer.mjs when include_unittest=true.

Execution Pipeline

StepFunctionPurposeInputOutput
1resolve_task_modeDetermine whether this request should go through create, migrate, enhance, or validate.task_mode<br>skill_request<br>legacy_skill_dir<br>legacy_skill_path<br>legacy_skill_content<br>existing_skill_filestask_context
2Asub-skills/create::collect_create_briefCreate/enhance lane: normalize user brief.skill_request<br>target_skill_path<br>skill_namecreate_context
2Bsub-skills/migrate::load_legacy_skill + map_existing_behavior + propose_function_split + extract_shared_referencesMigrate lane: read the legacy skill package, extract behaviors and migration evidence.legacy_skill_dir<br>legacy_skill_path<br>legacy_skill_content<br>migration_constraints<br>include_report<br>include_unittest<br>script_runtimemigration_context
3normalize_skill_blueprintConverge create / migrate / enhance inputs into a unified blueprint.task_context<br>create_context<br>migration_context<br>target_skill_path<br>include_report<br>include_unittestskill_blueprint
4design_skill_structureDesign function pipeline, references, scripts, testcases, and file layout based on blueprint.skill_blueprint<br>existing_skill_files<br>script_rulesskill_structure<br>script_plan<br>tool_plan
5draft_skill_artifactsDraft SKILL.md, function contracts, references, script specs, and testcase suggestions.skill_blueprint<br>skill_structure<br>script_planskill_artifacts
6add_runtime_capabilitiesProvision report log, runtime wrapper, unit testcase runner, viewer, and smoke tests according to include flags.skill_blueprint.include_report<br>skill_blueprint.include_unittest<br>skill_artifactsruntime_artifacts<br>skill_artifacts
7assemble_skill_filesGenerate or update target skill directory files.target_skill_path<br>skill_structure<br>skill_artifacts<br>runtime_artifacts<br>script_runtimefile_plan<br>created_files<br>updated_files
8validate_skillValidate functional-skill structure, runtime capabilities, testcases, and migration behavior preservation.target_skill_path<br>file_plan<br>skill_blueprint<br>report_modevalidation_result

Output Scope

This skill may read legacy skills and create or modify functional skill files under target_skill_path. Do not delete the original legacy skill unless the user explicitly requests deletion; do not modify unrelated repository files unless the user explicitly requests project-level integration.

Related skills