# Run Insights Recovery

> Analyzes completed runs to provide effort assessment, recovery recommendations, and next-session guidance. Use immediately after user saves a run, asks "how did I do?", or requests recovery advice.

- Skill: `majiayu000/run-insights-recovery` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/run-insights-recovery`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/run-insights-recovery/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/run-insights-recovery

---


## When Claude should use this skill
- Immediately after a run is saved
- When the user asks "how did I do?" or "what should I do next?"
- When user requests recovery advice or post-run analysis

## Invocation guidance
1. Provide `RecentRunTelemetry` plus derived metrics (pace stability, splits) and upcoming workouts.
2. Map effort to easy/moderate/hard and generate concise bullets.
3. Return `Insight` with `RecoveryRecommendation` and optional `nextSessionNudge`.

## Input schema (JSON)
```ts
{
  "run": RecentRunTelemetry,
  "derivedMetrics": { "paceStability": string, "cadenceNote"?: string, "hrNote"?: string },
  "upcomingWorkouts": Workout[],
  "userFeedback"?: { "rpe"?: number, "soreness"?: string }
}
```

## Output schema (JSON)
```ts
Insight
```

## Integration points
- API/hooks: Post-run pipeline in `v0/lib/run-recording.ts` and chat surface in `v0/lib/enhanced-ai-coach.ts`.
- UI: Today screen banners and run detail modal.
- Storage: Save alongside run in Dexie via `v0/lib/db.ts`.

## Safety & guardrails
- If HR missing, default to pace/RPE and add `SafetyFlag` with `missing_data`.
- If user reports pain/dizziness, advise stopping and consulting a professional; downgrade next session.
- Keep guidance ≤120 words; no medical diagnosis.

## Telemetry
- Emit `ai_skill_invoked` and `ai_insight_created` with `run_id`, `effort`, `safety_flags`.