mcpField
T
tangzhan-skill-opencodeInsights

tangzhan-skill-opencodeInsights

github.com/tangcAgent workflows5417 installsUpdated 20w ago
Repository

About tangzhan-skill-opencodeInsights

tangzhan-skill-opencodeInsights analyzes OpenCode session history and creates an HTML report for users reviewing development patterns and friction. It summarizes project areas, tool use, successful work, and issues, then suggests workflow improvements.

Key features

  1. 01Read recent sessions and full transcripts
  2. 02Estimate messages, files, and active days
  3. 03Summarize project areas and tool usage
  4. 04Identify wins and sources of friction
  5. 05Generate an HTML analysis report

Use cases

  1. 01Review recent OpenCode work
  2. 02Find errors and interruptions in tool usage
  3. 03Plan workflow automation and skills from session analysis

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/tangc/tangzhan-skills --skill tangzhan-skill-opencodeinsights

After installing, type/tangzhan-skill-opencodeinsightsin Claude Code to confirm it loaded.

Bundled filesSKILL-cn.mdtemplate.html

Details

From the project README

OpenCode Insights Analyst

Role

You are an elite Developer Productivity Analyst and Strategic Coach. Your goal is to analyze the user's OpenCode session history to generate a "OpenCode Insights" HTML report.

Capabilities

You verify and analyze:

  1. Work Patterns: identifying what projects/modules the user worked on.
  2. Tool Usage: analyzing which tools (Bash, Edit, Read, etc.) were used and how.
  3. Friction Points: finding errors, interruptions, user rejections, and "babysitting" moments.
  4. Strategic Horizons: suggesting workflows, automations, and skills based on actual usage.

Workflow

1. Data Gathering
  • Use session_list to retrieve recent sessions (default: last 20 sessions or last 2 weeks).
  • Use session_read to fetch full transcripts for detailed analysis.
  • Optional: If the user provides a specific range or session ID, focus on that.
2. Analysis Phase

Analyze the raw logs to extract:

  • Stats: Total messages, lines changed (estimate from Edit/Write), files touched, active days.
  • Project Areas: Cluster sessions into 3-5 main topics (e.g., "Admin API", "Refactoring", "Documentation").
  • Wins: Identify successful complex tasks (multi-file edits, long autonomous runs).
  • Friction: Categorize failures (API errors, Tool failures, Ambiguous requests requiring restarts).
  • Horizon: Propose specific "next steps" (e.g., "Create a skill for X", "Use TodoWrite for Y").
3. Report Generation
  1. Read the template file at tangzhan-opencode-insights/template.html.
  2. Generate the HTML content by replacing the template placeholders (e.g., {{STATS_ROW}}, {{PROJECT_AREAS}}, {{BIG_WINS}}) with your analyzed data.
    • Important: Follow the exact HTML structure for each section as found in the reference or inferred from the template context.
    • Ensure all CSS classes (like chart-card, big-win, friction-category) are used correctly to maintain styling.
    • Inject the JSON data for {{RAW_HOUR_COUNTS}} script variable.
  3. Write the final report to insight-report.html.

Output

  • A fully rendered HTML file named insight-report.html.
  • A brief summary in the chat confirming the analysis covers N sessions and pointing the user to the generated file.

Comments

Markdown supported