@vitness/fds-skill 0.1.0

package/prompts/exercise-classification.md

@@ -0,0 +1,173 @@
+# Exercise Classification Prompt
+
+## System Prompt
+
+```
+You are an expert exercise physiologist and fitness data specialist with deep knowledge of the FDS (Fitness Data Standard) specification.
+
+Your task is to classify exercises according to the FDS schema requirements. You must determine:
+1. exerciseType - The primary category of the exercise
+2. movement - The movement pattern (from 14 valid options)
+3. mechanics - Whether it's compound or isolation
+4. force - The force direction
+5. level - The difficulty level
+
+Always respond with valid JSON matching the expected schema. Be precise and consistent.
+```
+
+## User Prompt Template
+
+```
+Classify this exercise according to FDS v1.0.0:
+
+Exercise: {{name}}
+{{#if bodyPart}}Body Part: {{bodyPart}}{{/if}}
+{{#if target}}Target Muscle: {{target}}{{/if}}
+{{#if equipment}}Equipment: {{equipment}}{{/if}}
+{{#if description}}Description: {{description}}{{/if}}
+
+Provide classification as JSON with this exact structure:
+{
+  "exerciseType": "strength|cardio|mobility|plyometric|balance",
+  "movement": "squat|hinge|lunge|push-horizontal|push-vertical|pull-horizontal|pull-vertical|carry|core-anti-extension|core-anti-rotation|rotation|locomotion|isolation|other",
+  "mechanics": "compound|isolation",
+  "force": "push|pull|static|mixed",
+  "level": "beginner|intermediate|advanced",
+  "reasoning": "Brief explanation of your classification choices"
+}
+
+Classification Guidelines:
+- exerciseType: Consider the primary training goal (building strength, cardio endurance, flexibility, explosive power, or balance)
+- movement: Identify the primary movement pattern. Use "isolation" for single-joint exercises, "locomotion" for cardio-based movements
+- mechanics: "compound" if multiple joints move, "isolation" if single joint
+- force: Primary force direction - pushing away, pulling toward, static hold, or combination
+- level: Consider technique complexity and strength requirements
+
+Respond ONLY with the JSON object, no additional text.
+```
+
+## Expected Output Schema
+
+```json
+{
+  "type": "object",
+  "required": ["exerciseType", "movement", "mechanics", "force", "level"],
+  "properties": {
+    "exerciseType": {
+      "type": "string",
+      "enum": ["strength", "cardio", "mobility", "plyometric", "balance"]
+    },
+    "movement": {
+      "type": "string",
+      "enum": ["squat", "hinge", "lunge", "push-horizontal", "push-vertical", "pull-horizontal", "pull-vertical", "carry", "core-anti-extension", "core-anti-rotation", "rotation", "locomotion", "isolation", "other"]
+    },
+    "mechanics": {
+      "type": "string",
+      "enum": ["compound", "isolation"]
+    },
+    "force": {
+      "type": "string",
+      "enum": ["push", "pull", "static", "mixed"]
+    },
+    "level": {
+      "type": "string",
+      "enum": ["beginner", "intermediate", "advanced"]
+    },
+    "reasoning": {
+      "type": "string"
+    }
+  }
+}
+```
+
+## Example Inputs/Outputs
+
+### Example 1: Compound Strength
+**Input:**
+```
+Exercise: Barbell Back Squat
+Body Part: upper legs
+Target Muscle: glutes
+Equipment: barbell
+```
+
+**Output:**
+```json
+{
+  "exerciseType": "strength",
+  "movement": "squat",
+  "mechanics": "compound",
+  "force": "push",
+  "level": "intermediate",
+  "reasoning": "Back squat is a foundational compound strength exercise with a squat movement pattern. It involves knee and hip extension (pushing force). Requires proper technique and baseline strength, making it intermediate level."
+}
+```
+
+### Example 2: Isolation Exercise
+**Input:**
+```
+Exercise: Bicep Curl
+Target Muscle: biceps
+Equipment: dumbbell
+```
+
+**Output:**
+```json
+{
+  "exerciseType": "strength",
+  "movement": "isolation",
+  "mechanics": "isolation",
+  "force": "pull",
+  "level": "beginner",
+  "reasoning": "Bicep curl is a single-joint isolation exercise targeting the biceps. The elbow flexion is a pulling motion. Simple technique makes it beginner-friendly."
+}
+```
+
+### Example 3: Core Exercise
+**Input:**
+```
+Exercise: Plank
+Body Part: waist
+Target Muscle: abs
+Equipment: body weight
+```
+
+**Output:**
+```json
+{
+  "exerciseType": "strength",
+  "movement": "core-anti-extension",
+  "mechanics": "isolation",
+  "force": "static",
+  "level": "beginner",
+  "reasoning": "Plank is an isometric core exercise that resists spinal extension (anti-extension). Despite engaging multiple muscles, the joint action is minimal (isolation). Static hold with no movement. Basic technique accessible to beginners."
+}
+```
+
+### Example 4: Cardio
+**Input:**
+```
+Exercise: Treadmill Run
+Body Part: cardio
+Target Muscle: cardiovascular system
+Equipment: treadmill
+```
+
+**Output:**
+```json
+{
+  "exerciseType": "cardio",
+  "movement": "locomotion",
+  "mechanics": "compound",
+  "force": "mixed",
+  "level": "beginner",
+  "reasoning": "Running is a cardiovascular locomotion exercise. It's compound as it involves hip, knee, and ankle joints. Force is mixed between push-off and pull-through phases. Basic running is beginner-accessible."
+}
+```
+
+## Validation Rules
+
+1. All 5 required fields must be present
+2. Each field must use exact enum values (case-sensitive)
+3. The `reasoning` field helps with audit but is not stored in FDS
+4. If uncertain between two options, choose the more common/primary classification

package/prompts/exercise-description.md

@@ -0,0 +1,178 @@
+# Exercise Description Prompt
+
+## System Prompt
+
+```
+You are an expert fitness content writer with deep knowledge of exercise science and the FDS (Fitness Data Standard) specification.
+
+Your task is to write clear, concise, and accurate exercise descriptions. Descriptions should:
+1. Explain what the exercise is and its purpose
+2. Mention the primary muscles targeted
+3. Be suitable for a general fitness audience
+4. Be 1-3 sentences long
+5. Avoid overly technical jargon
+
+Always respond with valid JSON matching the expected schema.
+```
+
+## User Prompt Template
+
+```
+Write a description for this exercise:
+
+Exercise: {{name}}
+{{#if bodyPart}}Body Part: {{bodyPart}}{{/if}}
+{{#if target}}Target Muscle: {{target}}{{/if}}
+{{#if equipment}}Equipment: {{equipment}}{{/if}}
+{{#if classification}}
+Classification:
+- Type: {{classification.exerciseType}}
+- Movement: {{classification.movement}}
+- Mechanics: {{classification.mechanics}}
+{{/if}}
+
+Provide a JSON response:
+{
+  "description": "Your 1-3 sentence description here",
+  "aliases": ["alternative name 1", "alternative name 2"]
+}
+
+Guidelines:
+- Description should be informative but concise (50-150 words)
+- Start with what the exercise is, not "This exercise..."
+- Mention key muscles and benefits
+- Aliases should be common alternative names people might search for
+
+Respond ONLY with the JSON object, no additional text.
+```
+
+## Expected Output Schema
+
+```json
+{
+  "type": "object",
+  "required": ["description"],
+  "properties": {
+    "description": {
+      "type": "string",
+      "minLength": 20,
+      "maxLength": 500
+    },
+    "aliases": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 2
+      },
+      "maxItems": 5
+    }
+  }
+}
+```
+
+## Example Inputs/Outputs
+
+### Example 1: Compound Exercise
+**Input:**
+```
+Exercise: Barbell Back Squat
+Body Part: upper legs
+Target Muscle: glutes
+Equipment: barbell
+Classification:
+- Type: strength
+- Movement: squat
+- Mechanics: compound
+```
+
+**Output:**
+```json
+{
+  "description": "A foundational compound movement that targets the quadriceps, glutes, and hamstrings while engaging the core for stability. The barbell back squat builds lower body strength and power, making it essential for athletic performance and functional fitness.",
+  "aliases": ["back squat", "barbell squat", "high bar squat", "low bar squat"]
+}
+```
+
+### Example 2: Isolation Exercise
+**Input:**
+```
+Exercise: Dumbbell Bicep Curl
+Target Muscle: biceps
+Equipment: dumbbell
+Classification:
+- Type: strength
+- Movement: isolation
+- Mechanics: isolation
+```
+
+**Output:**
+```json
+{
+  "description": "An isolation exercise that targets the biceps brachii through elbow flexion. Dumbbell curls allow for independent arm training, helping address muscle imbalances while building arm size and strength.",
+  "aliases": ["bicep curl", "arm curl", "dumbbell curl", "DB curl"]
+}
+```
+
+### Example 3: Core Exercise
+**Input:**
+```
+Exercise: Plank
+Body Part: waist
+Target Muscle: abs
+Equipment: body weight
+Classification:
+- Type: strength
+- Movement: core-anti-extension
+- Mechanics: isolation
+```
+
+**Output:**
+```json
+{
+  "description": "An isometric core exercise that strengthens the entire anterior core by resisting spinal extension. The plank improves core stability, posture, and provides a foundation for more advanced exercises.",
+  "aliases": ["front plank", "prone hold", "hover"]
+}
+```
+
+### Example 4: Cardio Exercise
+**Input:**
+```
+Exercise: Jumping Jacks
+Body Part: cardio
+Target Muscle: cardiovascular system
+Equipment: body weight
+Classification:
+- Type: cardio
+- Movement: locomotion
+- Mechanics: compound
+```
+
+**Output:**
+```json
+{
+  "description": "A classic calisthenics exercise that elevates heart rate while engaging the entire body. Jumping jacks improve cardiovascular endurance, coordination, and serve as an effective warm-up or cardio interval exercise.",
+  "aliases": ["star jumps", "side-straddle hop"]
+}
+```
+
+## Quality Guidelines
+
+### Do
+- Be specific about muscles targeted
+- Mention practical benefits
+- Use active voice
+- Keep sentences clear and readable
+
+### Don't
+- Start with "This exercise is..."
+- Use excessive technical anatomy terms
+- Include form instructions (those go elsewhere)
+- Make health claims or guarantees
+- Be overly verbose
+
+### Alias Guidelines
+- Include common abbreviations (e.g., "DB" for dumbbell)
+- Include regional variations (e.g., "press-up" for "push-up")
+- Include equipment-less variants if applicable
+- Maximum 5 aliases
+- Exclude the main name

package/prompts/exercise-metrics.md

@@ -0,0 +1,278 @@
+# Exercise Metrics Prompt
+
+## System Prompt
+
+```
+You are an expert exercise physiologist familiar with the FDS (Fitness Data Standard) specification.
+
+Your task is to determine the appropriate metrics for tracking exercise performance. You must select:
+1. primary metric - The most important measurement for this exercise
+2. secondary metrics - Additional useful measurements (optional)
+
+Choose from the valid FDS metric types and units. Always respond with valid JSON.
+```
+
+## User Prompt Template
+
+```
+Determine the appropriate metrics for this exercise:
+
+Exercise: {{name}}
+{{#if classification}}
+Classification:
+- Exercise Type: {{classification.exerciseType}}
+- Movement: {{classification.movement}}
+- Mechanics: {{classification.mechanics}}
+{{/if}}
+{{#if equipment}}Equipment: {{equipment}}{{/if}}
+
+Provide metrics as JSON:
+{
+  "primary": {
+    "type": "<metric type>",
+    "unit": "<metric unit>"
+  },
+  "secondary": [
+    { "type": "<metric type>", "unit": "<metric unit>" }
+  ],
+  "reasoning": "Brief explanation of metric choices"
+}
+
+Valid metric types: reps, weight, duration, distance, speed, pace, power, heartRate, steps, calories, height, tempo, rpe
+
+Valid metric units:
+- count (for reps, tempo, rpe, steps)
+- kg, lb (for weight)
+- s, min (for duration)
+- m, km, mi (for distance)
+- m_s, km_h (for speed)
+- min_per_km, min_per_mi (for pace)
+- W (for power)
+- bpm (for heartRate)
+- kcal (for calories)
+- cm, in (for height)
+
+Common pairings:
+- Strength: reps/count + weight/kg
+- Cardio distance: distance/km + duration/min
+- Cardio time: duration/min + heartRate/bpm
+- Timed holds: duration/s
+- Plyometrics: reps/count + height/cm
+
+Respond ONLY with the JSON object, no additional text.
+```
+
+## Expected Output Schema
+
+```json
+{
+  "type": "object",
+  "required": ["primary"],
+  "properties": {
+    "primary": {
+      "type": "object",
+      "required": ["type", "unit"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["reps", "weight", "duration", "distance", "speed", "pace", "power", "heartRate", "steps", "calories", "height", "tempo", "rpe"]
+        },
+        "unit": {
+          "type": "string",
+          "enum": ["count", "kg", "lb", "s", "min", "m", "km", "mi", "m_s", "km_h", "min_per_km", "min_per_mi", "W", "bpm", "kcal", "cm", "in"]
+        }
+      }
+    },
+    "secondary": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["type", "unit"],
+        "properties": {
+          "type": { "type": "string" },
+          "unit": { "type": "string" }
+        }
+      }
+    },
+    "reasoning": {
+      "type": "string"
+    }
+  }
+}
+```
+
+## Example Inputs/Outputs
+
+### Example 1: Weighted Strength Exercise
+**Input:**
+```
+Exercise: Barbell Bench Press
+Classification:
+- Exercise Type: strength
+- Movement: push-horizontal
+- Mechanics: compound
+Equipment: barbell
+```
+
+**Output:**
+```json
+{
+  "primary": { "type": "reps", "unit": "count" },
+  "secondary": [
+    { "type": "weight", "unit": "kg" },
+    { "type": "rpe", "unit": "count" }
+  ],
+  "reasoning": "Bench press is tracked primarily by reps completed, with weight being the key secondary metric for progressive overload. RPE helps gauge effort relative to capacity."
+}
+```
+
+### Example 2: Bodyweight Exercise
+**Input:**
+```
+Exercise: Push-Up
+Classification:
+- Exercise Type: strength
+- Movement: push-horizontal
+- Mechanics: compound
+Equipment: body weight
+```
+
+**Output:**
+```json
+{
+  "primary": { "type": "reps", "unit": "count" },
+  "secondary": [
+    { "type": "tempo", "unit": "count" }
+  ],
+  "reasoning": "Bodyweight push-ups are primarily tracked by rep count. Tempo (e.g., 3-1-2-0 for eccentric-pause-concentric-pause) can be used to increase difficulty and time under tension."
+}
+```
+
+### Example 3: Timed Hold
+**Input:**
+```
+Exercise: Plank
+Classification:
+- Exercise Type: strength
+- Movement: core-anti-extension
+- Mechanics: isolation
+Equipment: body weight
+```
+
+**Output:**
+```json
+{
+  "primary": { "type": "duration", "unit": "s" },
+  "secondary": [],
+  "reasoning": "Plank is an isometric hold measured by duration in seconds. No secondary metrics are typically needed as progression comes from extending hold time."
+}
+```
+
+### Example 4: Distance Cardio
+**Input:**
+```
+Exercise: Treadmill Run
+Classification:
+- Exercise Type: cardio
+- Movement: locomotion
+- Mechanics: compound
+Equipment: treadmill
+```
+
+**Output:**
+```json
+{
+  "primary": { "type": "distance", "unit": "km" },
+  "secondary": [
+    { "type": "duration", "unit": "min" },
+    { "type": "pace", "unit": "min_per_km" },
+    { "type": "heartRate", "unit": "bpm" },
+    { "type": "calories", "unit": "kcal" }
+  ],
+  "reasoning": "Running is typically tracked by distance covered. Secondary metrics include time, pace for intensity, heart rate for training zone, and calories for energy expenditure."
+}
+```
+
+### Example 5: Time-Based Cardio
+**Input:**
+```
+Exercise: Stationary Bike
+Classification:
+- Exercise Type: cardio
+- Movement: locomotion
+- Mechanics: compound
+Equipment: cardio machine
+```
+
+**Output:**
+```json
+{
+  "primary": { "type": "duration", "unit": "min" },
+  "secondary": [
+    { "type": "distance", "unit": "km" },
+    { "type": "power", "unit": "W" },
+    { "type": "heartRate", "unit": "bpm" },
+    { "type": "calories", "unit": "kcal" }
+  ],
+  "reasoning": "Stationary biking is often tracked by time spent. Power (watts) is valuable for consistent intensity measurement. Distance, heart rate, and calories provide additional context."
+}
+```
+
+### Example 6: Plyometric Exercise
+**Input:**
+```
+Exercise: Box Jump
+Classification:
+- Exercise Type: plyometric
+- Movement: squat
+- Mechanics: compound
+Equipment: body weight
+```
+
+**Output:**
+```json
+{
+  "primary": { "type": "reps", "unit": "count" },
+  "secondary": [
+    { "type": "height", "unit": "cm" }
+  ],
+  "reasoning": "Box jumps are tracked by rep count, with box height as a secondary metric indicating intensity and explosive power capability."
+}
+```
+
+## Decision Guide
+
+```
+What type of exercise?
+├─ Strength (weighted)
+│  └─ Primary: reps/count
+│     Secondary: weight/kg, rpe/count
+│
+├─ Strength (bodyweight)
+│  └─ Primary: reps/count
+│     Secondary: tempo/count (optional)
+│
+├─ Isometric Hold
+│  └─ Primary: duration/s
+│     Secondary: (none typically)
+│
+├─ Cardio (distance-based)
+│  └─ Primary: distance/km
+│     Secondary: duration/min, pace/min_per_km, heartRate/bpm
+│
+├─ Cardio (time-based)
+│  └─ Primary: duration/min
+│     Secondary: distance/km, heartRate/bpm, calories/kcal
+│
+├─ Cardio (power-based, e.g., rowing, cycling)
+│  └─ Primary: duration/min OR distance/m
+│     Secondary: power/W, heartRate/bpm
+│
+├─ Plyometric
+│  └─ Primary: reps/count
+│     Secondary: height/cm (for jumps)
+│
+└─ Mobility/Flexibility
+   └─ Primary: duration/s (for holds)
+      OR reps/count (for dynamic stretches)
+```