What are the Quality Gates for saved insights?

To prevent low-quality documentation, a learning must be specific, testable, recurrent (likely to happen again), and worth the cost of reading it in every future session.

What is the Work Reflection skill for Claude Code?

It is a specialized capability that allows Claude to analyze your work session for learnings, friction, and successes, then save those insights into structured Linear documents for future reference.

How do I use the reflection command?

Simply use the slash command '/reflect' followed by an optional project name and focus text to trigger an analysis and update your knowledge base.

How does the two-layer knowledge architecture work?

The skill separates knowledge into two tiers: Layer 1 covers cross-cutting rules like communication tone and general workflow, while Layer 2 covers project-specific decisions and technical patterns.

Does this skill work with Linear?

Yes, it is specifically designed to update 'Work Patterns & Communication' documents in Management projects and 'Updates & Learnings' docs in specific Linear projects.

Work Reflection & Knowledge Capture

Name: Work Reflection & Knowledge Capture
Author: mberto10

bymberto10

0•

Productivity & Workflow

Captures and organizes work session insights into structured Linear documentation using a two-layer knowledge architecture.

The Work Reflection skill automates the process of institutionalizing knowledge by transforming ephemeral session insights into actionable documentation within Linear. It utilizes a sophisticated two-layer architecture that separates general workflow rules (Management) from project-specific technical patterns, ensuring that Claude continuously evolves based on past successes and corrections. By applying rigorous quality gates and a standardized heuristic format, the skill prevents documentation bloat while ensuring every saved insight is specific, testable, and high-value for future sessions.

Key Features

01Integrated quality gates to filter for specific, testable, and recurrent insights.

02Silent knowledge consulting that automatically applies saved rules to future tasks like email drafting or meeting prep.

03Automated analysis of session friction, corrections, and successes via the /reflect command.

04Two-layer knowledge architecture separating global work patterns from project-specific context.

05Standardized heuristic formatting for actionable, source-tracked learnings (rule|feature|fix).

060 GitHub stars

Use Cases

01Improving workflow efficiency by identifying and automating recurrent patterns across multiple projects.

02Capturing project-specific domain context and technical decisions to inform future development.

03Institutionalizing feedback after receiving corrections on communication tone or reporting styles.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mberto10/mberto-compound reflection-work

For use in Claude.ai and ChatGPT

Download Skill