agentleFS
YunghoYungho/family-doctor/musculoskeletal-care/SKILL.md

musculoskeletal-care

Skill2 starsChanged 8 months agoMITView on GitHub

Comprehensive musculoskeletal and orthopedic health management. Covers joint pain (knee, shoulder, hip), spinal conditions (low back pain, cervical pain, disc herniation), osteoporosis, sports injuries (sprains, meniscus tears), arthritis, tendonitis, and fracture rehabilitation. Provides dual-mode output: symptom assessment for initial consultations and disease profiles for long-term tracking. Triggers on semantic intent (body part + pain, movement limitation, injury scenario) not just keywords. Triggers: knee pain, low back pain, neck pain, shoulder pain, osteoporosis, meniscus tear, disc herniation, tendonitis, arthritis, sprain, 膝盖痛, 腰痛, 颈椎痛, 骨质疏松, 半月板损伤, 腱鞘炎, 关节炎.

The file

Files
SKILL.md

Musculoskeletal Care — Orthopedic & Sports Medicine Companion

IMPORTANT: I help you understand musculoskeletal symptoms and manage orthopedic conditions. I do NOT provide diagnoses. Always consult a healthcare professional for medical evaluation.

🎯 Trigger Strategy

Semantic Intent Recognition (优先)

系统首先通过语义理解判断用户意图,而非仅依赖关键词。

意图模式:

PatternExample (EN)Example (ZH)
Body part + pain"My knee hurts""膝盖不太舒服"
Movement limitation"Can't bend down""弯不下腰"
Injury scenario"Twisted my ankle playing""打球扭到了"
Functional impact"Hard to raise my arm""手举不起来"
Recovery inquiry"When can I exercise again?""多久能恢复运动"

Keyword Triggers (补充)

  • EN: knee pain, low back pain, neck pain, shoulder pain, osteoporosis, meniscus tear, disc herniation, tendonitis, arthritis, sprain, fracture, frozen shoulder, rotator cuff, plantar fasciitis, carpal tunnel
  • ZH: 膝盖痛, 腰痛, 颈椎痛, 肩痛, 骨质疏松, 半月板损伤, 腰间盘突出, 腱鞘炎, 关节炎, 扭伤, 腰肌劳损

📋 Coverage

Joint Conditions (关节)

ConditionKey Features
Knee painMeniscus tear, ACL/PCL injury, patellar chondromalacia, osteoarthritis
Shoulder painFrozen shoulder, rotator cuff tear, impingement syndrome
Hip painHip osteoarthritis, femoral head necrosis, labral tear
Ankle/WristSprains, ligament injuries, instability

Spinal Conditions (脊柱)

ConditionKey Features
Low back painLumbar disc herniation, lumbar strain, spinal stenosis
Neck painCervical spondylosis, cervical disc herniation, muscle tension

Bone & Metabolic (骨骼代谢)

ConditionKey Features
OsteoporosisBone density loss, fracture risk, T-score interpretation

Soft Tissue & Inflammatory (软组织炎症)

ConditionKey Features
TendinopathyTendonitis, tendinosis, de Quervain's, Achilles tendinopathy
Plantar fasciitisHeel pain, arch pain
Carpal tunnelWrist numbness, tingling

Rehabilitation (康复)

PhaseFocus
Post-fractureRange of motion, strengthening, return to activity
Post-surgicalJoint replacement, arthroscopy rehab
Sports injuryProgressive loading, return-to-sport criteria

🚦 Dual-Mode Output

Mode 1: Symptom Assessment (Initial Consultation)

# Musculoskeletal Assessment — [Date]

## 🔍 Your Symptoms
- **Primary**: [Symptom description]
- **Location**: [Body part]
- **Duration**: [Acute <6 weeks / Chronic >6 weeks]
- **Severity**: [0-10 pain scale]
- **Onset**: [Sudden / Gradual]
- **Aggravating factors**: [What makes it worse]
- **Relieving factors**: [What helps]

---

## 🚨 Red Flags Check
- [ ] Severe trauma + inability to bear weight
- [ ] Joint redness, swelling, warmth + fever
- [ ] Progressive numbness/weakness (神经症状)
- [ ] Night pain waking you from sleep
- [ ] Unexplained weight loss
- [ ] Bowel/bladder dysfunction (脊柱相关)

---

## 🚦 Care Recommendation

**Level**: Self-care / Primary care / Urgent care / Emergency

**Rationale**:
- [Clinical reasoning]

**Timeline**:
- [When to reassess]

---

## ✅ Self-Care Suggestions

1. **RICE Protocol** (for acute injuries)
   - Rest: Avoid aggravating activities
   - Ice: 15-20 min every 2-3 hours
   - Compression: Elastic bandage if swelling
   - Elevation: Above heart level when possible

2. **Pain Management**
   - OTC options: Acetaminophen or NSAIDs (if safe)
   - Topical: Ice/heat alternating

3. **Gentle Movement**
   - Maintain range of motion within pain-free limits
   - Avoid complete immobilization unless advised

---

## ⚠️ Warning Signs (See Doctor If)
- Pain worsening after 1-2 weeks of self-care
- New symptoms developing
- Inability to perform daily activities
- Signs of infection (redness, warmth, fever)

---

## 📅 Follow-up
- **Reassess**: [Timeframe]
- **Next steps**: [Specific actions]

Mode 2: Disease Profile (Long-term Tracking)

# [Condition] Profile

## Overview
- **Diagnosis**: [Description]
- **Onset**: [Date]
- **Severity**: [Mild / Moderate / Severe]
- **Status**: Active / Monitoring / Resolved

---

## 📊 Classification & Staging

### Osteoarthritis (Kellgren-Lawrence)
| Grade | X-ray Findings | Management |
|-------|----------------|------------|
| 0 | Normal | Prevention |
| 1 | Doubtful JSN | Lifestyle |
| 2 | Definite osteophytes | PT + lifestyle |
| 3 | Moderate JSN | Consider injections |
| 4 | Severe JSN | Surgical consult |

### Osteoporosis (T-score)
| Category | T-score | Action |
|----------|---------|--------|
| Normal | ≥ -1.0 | Maintain |
| Osteopenia | -1.0 to -2.5 | Prevention |
| Osteoporosis | ≤ -2.5 | Treatment |
| Severe | ≤ -2.5 + fracture | Aggressive treatment |

### Disc Herniation (Modified MacNab)
| Grade | Description | Management |
|-------|-------------|------------|
| Protrusion | Disc bulging | Conservative |
| Extrusion | Disc material outside annulus | Consider injection |
| Sequestration | Free fragment | Surgical consult |

---

## 📈 Tracking Metrics

| Metric | Current | Target | Status |
|--------|---------|--------|--------|
| Pain (0-10) | [value] | ≤3 | ✅/⚠️/❌ |
| Range of motion | [value] | Normal | ✅/⚠️/❌ |
| Functional score | [value] | [target] | ✅/⚠️/❌ |
| Activity level | [value] | [target] | ✅/⚠️/❌ |

---

## 🔗 Correlation Analysis

### Factors Affecting Your Condition
| Factor | Impact | Recommendation |
|--------|--------|----------------|
| Sleep quality | r = -0.5 | Prioritize 7-8 hours |
| Weight/BMI | r = 0.6 | Maintain healthy BMI |
| Activity level | U-shaped | Balance rest and movement |
| Stress | r = 0.4 | Stress management |

---

## 📋 Management Plan

### Current
- **Medications**: [List]
- **Physical therapy**: [Status]
- **Activity modifications**: [Specific changes]

### Goals
- **Short-term** (4 weeks): [Goal]
- **Long-term** (3-6 months): [Goal]

---

## 📅 Follow-up Schedule

| Assessment | Frequency | Next Due |
|------------|-----------|----------|
| Pain evaluation | Weekly | [Date] |
| Range of motion | Monthly | [Date] |
| Imaging (if indicated) | Per guidelines | [Date] |
| Bone density (if osteoporosis) | Every 1-2 years | [Date] |

---

## ⚠️ Red Flags for This Condition
- [Condition-specific warning signs]

---

## 📚 Patient Education
- [Condition-specific education points]

🏥 Condition-Specific Guidelines

Knee Pain

Common Causes:

  • Meniscus tear (半月板损伤)
  • Osteoarthritis
  • Ligament injury (ACL/MCL)
  • Patellar tendinopathy

Assessment Questions:

  1. Did you have a specific injury or did it develop gradually?
  2. Does the knee lock, catch, or give way?
  3. Where exactly is the pain? (medial, lateral, anterior, posterior)
  4. Any swelling? When did it start?

Red Flags:

  • Knee locked in position
  • Severe instability
  • Significant swelling within 2 hours of injury

Low Back Pain

Common Causes:

  • Lumbar strain (腰肌劳损)
  • Disc herniation (腰间盘突出)
  • Spinal stenosis
  • Facet joint syndrome

Assessment Questions:

  1. Does the pain radiate to your leg? (sciatica)
  2. Any numbness or weakness in the leg/foot?
  3. Does coughing or sneezing worsen the pain?
  4. Any bowel or bladder changes?

Red Flags:

  • Cauda equina syndrome (saddle anesthesia, bowel/bladder dysfunction)
  • Progressive neurological deficit
  • History of cancer with new back pain
  • Fever with back pain

Neck Pain

Common Causes:

  • Cervical strain (颈椎痛)
  • Cervical spondylosis
  • Disc herniation
  • Thoracic outlet syndrome

Red Flags:

  • Upper extremity weakness
  • Gait disturbance
  • Lhermitte's sign (electric shock with neck flexion)

Osteoporosis

Risk Factors:

  • Age >65 (women), >70 (men)
  • Previous fragility fracture
  • Family history
  • Low BMI
  • Smoking, excessive alcohol
  • Long-term corticosteroid use

T-score Interpretation:

  • ≥ -1.0: Normal
  • -1.0 to -2.5: Osteopenia (预防阶段)
  • ≤ -2.5: Osteoporosis (需要治疗)
  • ≤ -2.5 + fracture: Severe osteoporosis

🔗 Cross-References

This skillRelated skillRelationship
musculoskeletal-carefitness-coachRehabilitation exercises, return-to-sport
musculoskeletal-carechronic-careOsteoporosis long-term management
musculoskeletal-caremedication-managerNSAIDs, analgesics tracking
musculoskeletal-carepreventive-careBone density screening
musculoskeletal-carenutrition-advisorCalcium, Vitamin D intake
musculoskeletal-carehealth-trend-analyzerPain trend analysis
musculoskeletal-caresymptom-assistantSymptom assessment pattern

🛡️ Safety Boundaries

✅ This Skill CAN

  • Help you understand musculoskeletal symptoms
  • Track pain levels and functional status over time
  • Provide evidence-based self-care suggestions
  • Explain imaging results and classifications
  • Guide rehabilitation progression
  • Identify when to seek professional care

❌ This Skill CANNOT

  • Diagnose conditions
  • Interpret X-rays, MRI, or CT scans
  • Prescribe medications
  • Perform physical examinations
  • Replace orthopedic or sports medicine consultation
  • Predict surgical outcomes

🚨 Emergency Protocol

Seek IMMEDIATE care for:

  • Severe trauma with inability to bear weight
  • Joint redness + warmth + fever (septic joint)
  • Progressive numbness/weakness in extremity
  • Bowel/bladder dysfunction (cauda equina)
  • Open fractures
  • Suspected compartment syndrome (pain out of proportion, tense compartment)

📚 Clinical References

Guidelines

  • Osteoarthritis: ACR/AAOS 2019 Guidelines
  • Low back pain: NICE 2016, ACP 2017
  • Osteoporosis: NOF 2014, Endocrine Society 2019
  • Knee injuries: AAOS 2015 ACL Guidelines
  • Rotator cuff: AAOS 2019
  • Fractures: AO Foundation, OrthoGuides

Evidence

  • Exercise therapy for osteoarthritis: Juhl C, et al. Br J Sports Med (2014)
  • Core stabilization for low back pain: Wang XQ, et al. J Pain Res (2012)
  • Bisphosphonates for osteoporosis: Black DM, et al. Lancet (2007)

Version: v1.0.0 Created: 2026-03-23 Maintainer: Family Doctor Team

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.