running-coach-index

Reference catalog for all running coach AI skills, shared TypeScript contracts, safety guardrails, and telemetry conventions. Use when working with any running coach feature to understand data schemas, safety patterns, or integration points.

First seen Apr 27, 2026

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Declared

Cursor Not declared

Codex Not declared

GitHub Copilot Not declared

Windsurf Not declared

Gemini CLI Not declared

Cline Not declared

OpenCode Not declared

Skill metadata

Parsed from SKILL.md frontmatter.

Declared agents claude-code

More metadata

short-description: Catalog of AI skills, contracts, telemetry, and guardrails for Run-Smart.

Package contents

Files included with this skill beyond the listing page.

skill md SKILL.md 3,422 B

docs SUMMARY.md 268 B

History

Apr 27, 2026 First seen on skills.sh

Sep 9, 2026 First recorded snapshot · 1 installs

SKILL.md

Purpose

Defines the shared conventions, contracts, safety posture, and telemetry used by all Run-Smart AI skills. This index allows Claude to discover available skills and the rules they follow.

When Claude should use this skill

Before invoking any Run-Smart skill to understand shared schemas, safety guidance, and telemetry
When onboarding a new skill to ensure compliance with common contracts
When working with running coach features and need to understand data schemas or safety patterns

Invocation guidance

Load shared references in running-coach-index/references/ (contracts, telemetry, conventions, smoke-tests).
Select the appropriate skill directory based on the user's need (plan generation, adjustment, insights, etc.).
Validate request/response payloads against the schemas in contracts.md and skill-specific schemas.

Shared components

Contracts: running-coach-index/references/contracts.md
Telemetry: running-coach-index/references/telemetry.md
Conventions: running-coach-index/references/conventions.md
Smoke tests: running-coach-index/references/smoke-tests.md

Safety & guardrails

No medical diagnosis. If pain/dizziness/severe symptoms appear, advise stopping activity and consulting a qualified professional.
Prefer conservative adjustments under uncertainty.
Emit SafetyFlag objects when thresholds are crossed and log via aisafetyflag_raised.

Integration points

Skills are invoked from chat flows (v0/app/api/chat/route.ts, v0/lib/enhanced-ai-coach.ts), plan generation APIs (v0/app/api/generate-plan/route.ts), background jobs (plan adjustment), and post-run screens.

Telemetry events (standard)

aiskillinvoked
aiplangenerated
aiadjustmentapplied
aiinsightcreated
aisafetyflag_raised
aiuserfeedback

Agent Team (Swarm) Coordination

RunSmart skills are designed to work in agent teams (Opus 4.6+). When running in a swarm, each teammate inherits all skills via CLAUDE.md and .claude/skills/.

Swarm-Aware Skills

swarm-orchestrator: Master patterns for spawning and coordinating teams
dev-swarm: Parallel development with architect/frontend/backend/QA roles
marketing-swarm: Multi-channel marketing campaigns with specialist agents
ops-deploy: Deployment and production operations
growth-analytics: Metrics, funnels, and experiment frameworks
pwa-distribution: App store optimization and distribution channels
community-growth: User acquisition and community building

Coordination Conventions

Running coach domain skills (plan-generator, readiness-check, etc.) are used

by individual teammates — they don't need their own team.

Swarm skills (dev-swarm, marketing-swarm) define team compositions and

task dependency patterns for multi-agent work.

The swarm-orchestrator skill provides the master patterns that all other

swarm skills follow.

All teammates respect safety guardrails from this index.