opencode-skill-mastery

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