메뉴
Add a new built-in exercise to Liftosaur end-to-end — image (gymvisual.com → S3), catalog registration, description page, and the LLM/MCP exercise list. Use when adding one or more built-in exercises to the app catalog.
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/astashov/liftosaur --skill add-exercise명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
SOC 직업 분류 기준
SKILL.md 표시 중
| name | add-exercise |
| description | Add a new built-in exercise to Liftosaur end-to-end — image (gymvisual.com → S3), catalog registration, description page, and the LLM/MCP exercise list. Use when adding one or more built-in exercises to the app catalog. |
| disable-model-invocation | true |
| argument-hint | [Exercise Name] [equipment] |
Add the exercise(s): $ARGUMENTS
A built-in exercise touches six places. Do them in order. Worked example throughout:
Nordic Curl, id nordicCurl, equipment bodyweight, image key nordiccurl_bodyweight.
IExerciseId — camelCase, e.g. nordicCurl. It's a free v.string() (src/types.ts), so there is no enum/picklist to update. Pick an id that is NOT exactly 8 lowercase letters (avoids the theoretical collision space with random custom-exercise ids).Nordic Curl.equipments in src/types.ts (bodyweight, barbell, dumbbell, cable, , , , , , , ).leverageMachinebandkettlebellsmithezbartrapbarmedicineballid + "_" + equipment, e.g. nordiccurl_bodyweight. Used for the S3 image filename, the exerciseImage.ts sets, and the exercises/*.md filename.Illustrations come from purchased gymvisual.com assets, cropped and uploaded to the images S3 bucket by src/imageExtractorGymVisual.ts.
If the exercise reuses an existing exercise's image (e.g. a slight variant): skip S3 entirely and instead set reuseImageFrom: { id, equipment } on the exercise entry in Step 2. Then skip to Step 2.
Otherwise, get a new image (manual, human-in-the-loop — costs money):
npx ts-node ./scripts/gymvisual_search.ts "nordic curl" "hamstring curl" "glute ham raise"
ts-node directly, not npm run r — npm strips quotes and splits multi-word terms.) It prints candidate exercises grouped across formats, illustrations first with preview image URLs. Only the illustrations category yields the transparent multi-pose PNG the extractor needs; exercises that exist only as gif/video are flagged as not-extractable. Pick the right illustrations/<id>-<slug>.html product, eyeballing the preview: image. --all lists gif/video-only matches; --max=N widens the scan per term.boxIndex, 0-based, counted left-to-right) to use as the single-pose thumbnail.<src>/<id>_<equipment>_<boxIndex>/ containing the downloaded file whose name matches /_medium/ (e.g. nordiccurl_bodyweight_2/xxx_medium.png).convert on PATH, and AWS credentials with write access to the images bucket.npx ts-node src/imageExtractorGymVisual.ts <src-dir> <dest-dir>
400x600 (→ exercises/single/small/) and the combined sheet to 800x600 (→ exercises/full/large/), uploads both to S3, then prints "Available small images" and "Available large images" arrays.src/models/exerciseImage.ts, replacing the availableSmallImages and availableLargeImages set contents (entries are lowercased id_equipment). At minimum the new nordiccurl_bodyweight must appear in both sets — ExerciseImageUtils_exists gates whether the app shows an image.src/models/exercise.ts)Add to allExercisesList (keep it alphabetically near its neighbors):
nordicCurl: {
id: "nordicCurl",
name: "Nordic Curl",
defaultWarmup: 10,
defaultEquipment: "bodyweight",
types: ["lower"],
startingWeightLb: { value: 0, unit: "lb" },
startingWeightKg: { value: 0, unit: "kg" },
},
types — subset of upper/lower/push/pull/legs/core. Copy from the closest analogous exercise.startingWeight* — 0 for pure bodyweight; otherwise a sane starting load matching similar exercises.reuseImageFrom: { id: "...", equipment: "..." } here if you skipped Step 1.Add to the metadata record (same file, keyed by id):
nordicCurl: {
targetMuscles: ["Hamstrings"],
synergistMuscles: ["Gastrocnemius", "Gluteus Maximus"],
},
targetMuscles / synergistMuscles must be exact literals from the availableMuscles list in src/types.ts (typed as IMuscle) — inventing a name is a type error. The allowed values:
Adductor Brevis, Adductor Longus, Adductor Magnus, Biceps Brachii, Brachialis, Brachioradialis, Deltoid Anterior, Deltoid Lateral, Deltoid Posterior, Erector Spinae, Gastrocnemius, Gluteus Maximus, Gluteus Medius, Hamstrings, Iliopsoas, Infraspinatus, Latissimus Dorsi, Levator Scapulae, Obliques, Pectineous, Pectoralis Major Clavicular Head, Pectoralis Major Sternal Head, Quadriceps, Rectus Abdominis, Sartorius, Serratus Anterior, Soleus, Splenius, Sternocleidomastoid, Tensor Fasciae Latae, Teres Major, Teres Minor, Tibialis Anterior, Trapezius Lower Fibers, Trapezius Middle Fibers, Trapezius Upper Fibers, Triceps Brachii, Wrist Extensors, Wrist Flexors
(Check src/types.ts for the current source of truth.) When unsure which muscles apply, copy from the metadata entry of the most analogous exercise.
exercises/<id>_<equipment>.md)Filename is lowercased: exercises/nordiccurl_bodyweight.md. Format:
---
video: "<youtube-id>"
description: "One-sentence summary of the exercise and what it trains."
---
## Starting Position
1. ...
## Movement
1. ...
## Key Points
- ...
<!-- howto -->
### Set Up Your Position
Plain-prose step.
### Execute the Movement
Plain-prose step.
video — the YouTube video id only (the abc123XYZ part, not the full URL). Find a real, good demonstration video; do not fabricate an id.<!-- howto --> is the form guide; everything after is parsed into ### Heading + prose steps (see scripts/build-exercises.ts).exercises/pushup_bodyweight.md, exercises/pistolsquat_bodyweight.md) and the writing guidance in .claude/commands/describe-technique.md.Then regenerate the compiled descriptions (never hand-edit the generated file):
npm run build:exercises
This rewrites src/models/exerciseDescriptions.ts, keyed by nordiccurl_bodyweight.
llms/exercises.md)Add the display name to llms/exercises.md (this manually-maintained list is compiled to src/generated/exercises.ts by scripts/build-markdown.js and surfaced to the LLM/MCP via lambda/mcp/reference.ts). Match the existing formatting, including per-equipment variants (Name, Equipment) if the exercise ships with more than its default equipment. The regeneration runs as part of the normal build.
npx tsc --noEmit — no type errors.npx mocha --require ts-node/register test/exercise.test.ts.Users often create custom exercises to fill catalog gaps. When a new built-in shares a name with a user's custom exercise, resolution prefers the custom one, so existing programs/history never silently re-point to the new built-in. This is enforced in Exercise_findIdByName / Exercise_findByNameAndEquipment (src/models/exercise.ts, custom-index checked before nameToIdMapping) and covered by test/exercise.test.ts ("custom exercise wins over built-in on name collision"). You don't need to do anything per-exercise — just be aware that picking a display name that matches an existing custom exercise is safe by design.