opencode-skill-mastery

Automatic skill mastery tracking for OpenCode. Extracts technologies from conversations and tracks proficiency levels.

Features

• Automatic extraction: Intercepts tool calls to detect technologies used
• Smart mapping: File extensions → languages, commands → tools/frameworks
• Evidence-based tracking: Tracks usage patterns with decay over time
• 4-tier mastery levels: 了解 → 熟悉 → 熟练 → 精通
• LLM analysis: On-demand skill assessment via analyze-skills tool

Installation

npm install opencode-skill-mastery

Add to ~/.config/opencode/opencode.json:

{
  "plugin": ["opencode-skill-mastery"]
}

How It Works

Automatic Tracking

The plugin intercepts tool calls and extracts evidence:

| Tool | Extraction | Example | |------|-----------|---------| | write / edit | File extension → language | .py → Python | | bash | Command prefix → tools | npm → Node.js | | read | File extension → knowledge | .rs → Rust |

Evidence Decay

Recent evidence weighs more than older evidence:

weight = base_weight * (0.95 ^ days_since_evidence)

Mastery Levels

| Level | Confidence | Description | |-------|------------|-------------| | 了解 | 0-40% | Basic awareness, mentioned in conversation | | 熟悉 | 40-65% | Basic usage demonstrated | | 熟练 | 65-85% | Independent usage, problem-solving | | 精通 | 85-100% | Deep knowledge, optimization, teaching |

Usage

Automatic (Default)

Skills are tracked automatically as you use different technologies. No action needed.

Manual Analysis

Ask the agent to analyze your skills:

• "What skills do I have?"
• "Assess my technical abilities"
• "Generate a skill report"

The agent will use the analyze-skills tool to generate a report.

Analysis Types

• summary: Quick overview of all skills
• report: Formatted report grouped by mastery level
• full: Complete JSON data dump

CLI Tool (Extract from Historical Sessions)

# List recent sessions
opencode-extract-skills --list

# Extract from specific sessions
opencode-extract-skills ses_abc123 ses_def456

# Extract from 10 most recent sessions
opencode-extract-skills --recent 10

# Extract from ALL sessions
opencode-extract-skills --all

Data Storage

Skills are stored in ~/.config/opencode/skill-mastery.json:

{
  "skills": {
    "TypeScript": {
      "level": "熟练",
      "confidence": 0.75,
      "evidence": [...],
      "lastUpdated": "2026-06-14"
    }
  },
  "lastAssessment": "2026-06-14"
}

Compatibility

• Works with all OpenCode agents
• Compatible with skill-mastery-tracker skill
• No conflicts with other plugins

License

MIT