reflect

Analyzes OpenCode session history to recommend reusable skills, agents, and config changes.

Updated Sep 13, 2023
One-click install
npx skills add https://github.com/dlwlrmax/.dotfiles --skill reflect-dlwlrmax
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reflect
Source: https://github.com/dlwlrmax/.dotfiles/tree/main/opencode/.config/opencode/skills/reflect
Command: npx skills add https://github.com/dlwlrmax/.dotfiles --skill reflect-dlwlrmax

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Repeated manual workflows and recurring friction across AI coding sessions go unnoticed, so users keep re-explaining the same processes instead of turning them into reusable skills, commands, or agent instructions. ## Core Features & Use Cases - Workflow Pattern Detection: Reviews recent sessions, project notes, and existing agent assets to find repeated friction with frequency, confidence, and impact scoring. - Session Archaeology Mode: Queries the OpenCode SQLite database directly to analyze historical sessions across all repos, with per-session summaries cached as JSON to save tokens. - Conservative Recommendations: Proposes the smallest useful improvement (prompt rule, skill, command, agent, config change, or playbook) and asks for approval before changing anything. - Use Case: Run /reflect --sessions --last 100 after weeks of coding to discover that you repeatedly grep for test files before editing, then get a concrete proposal for a reusable command that eliminates that friction. ## Quick Start Ask the agent to run /reflect --sessions to analyze your recent OpenCode sessions and suggest reusable workflow improvements.

Frequently Asked Questions about reflect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze my OpenCode session history for repeated patterns?▼

Run /reflect --sessions to query the OpenCode SQLite database at ~/.local/share/opencode/opencode.db. It loads recent sessions and messages, summarizes each with friction points and recommendations, then aggregates findings across repos.

How to turn repeated AI coding workflows into reusable skills?▼

Run /reflect with an optional focus area. It inventories existing skills, agents, and commands first, scores repeated patterns by frequency and cost, then proposes the smallest useful form such as a prompt rule, skill, or command before making any change.

Does reflect modify my OpenCode config automatically?▼

No. Reflect presents a concise proposal and asks for approval before writing files or changing config, prompts, agents, or MCP permissions. Changes apply on the next OpenCode run, and a restart is needed for immediate effect.

What happens when session analysis finds no repeated patterns?▼

Reflect treats 'create nothing' as a successful outcome. It reports that no strong repeated workflow was found and lists weak candidates under 'Needs more evidence' with what would make them actionable.

Why are some sessions skipped during reflect analysis?▼

Sessions are skipped when they cannot be loaded from the database or contain no messages. Reflect logs each failure, continues with remaining sessions, and reports the total skipped count at the end.