Insight Awareness
by mnthe
Use this skill when you want to learn about generating high-quality insights that will be automatically captured. Insights using the "★ Insight" format are automatically extracted by hooks - no manual saving required.
Skill Details
Repository Files
1 file in this skill directory
name: insight-awareness description: Use this skill when you want to learn about generating high-quality insights that will be automatically captured. Insights using the "★ Insight" format are automatically extracted by hooks - no manual saving required.
Insight Awareness
Overview
This skill guides you on creating valuable insights that will be automatically captured by hooks. You don't need to manually save insights - just generate them in the ★ Insight format and the Stop/SubagentStop hooks will extract them from the transcript.
How It Works
1. You generate: ★ Insight ─────────────────────────────────────
[valuable knowledge]
─────────────────────────────────────────────────
2. Hook automatically:
- Parses transcript after your response
- Extracts content between markers
- Saves to ~/.claude/knowledge-extraction/{session-id}/insights.md
- Tracks state to avoid duplicates
When to Generate Insights
Generate ★ Insight markers when you discover:
| Type | Description | Example |
|---|---|---|
code-pattern |
Reusable patterns | "Prefer useReducer for complex form state" |
workflow |
Efficient processes | "Run tests before commit hooks" |
debugging |
Root cause findings | "Memory leak caused by unclosed listener" |
architecture |
Design decisions | "Use event sourcing for audit trail" |
tool-usage |
Effective techniques | "Combine Grep + Read for targeted searches" |
standard |
Standards and conventions | "JSON files use 2-space indentation" |
convention |
Naming and file patterns | "Scripts follow entity-action.js naming" |
Quality Guidelines
Worth Capturing
- Non-obvious solutions or patterns
- Project-specific conventions discovered
- Tool combinations that worked well
- Debugging techniques that solved real issues
- Architectural rationale with tradeoffs
Not Worth Capturing
- Basic syntax or API usage (available in docs)
- Temporary workarounds without lasting value
- User-specific preferences without broader applicability
- Information already documented in project
Insight Format
Use the standard format for automatic extraction:
★ Insight ─────────────────────────────────────
[2-5 lines of valuable, reusable knowledge]
─────────────────────────────────────────────────
Commands
After insights accumulate:
/insights- View collected insights/insights extract- Convert to Skills/Commands/CLAUDE.md/Rules Files/insights clear- Clear session insights
Key Points
- Just generate - Hooks handle saving automatically
- Quality over quantity - Only create insights worth preserving
- Be specific - Include context for discoverability
- Use standard format - Ensures hook can extract properly
Related Skills
Attack Tree Construction
Build comprehensive attack trees to visualize threat paths. Use when mapping attack scenarios, identifying defense gaps, or communicating security risks to stakeholders.
Grafana Dashboards
Create and manage production Grafana dashboards for real-time visualization of system and application metrics. Use when building monitoring dashboards, visualizing metrics, or creating operational observability interfaces.
Matplotlib
Foundational plotting library. Create line plots, scatter, bar, histograms, heatmaps, 3D, subplots, export PNG/PDF/SVG, for scientific visualization and publication figures.
Scientific Visualization
Create publication figures with matplotlib/seaborn/plotly. Multi-panel layouts, error bars, significance markers, colorblind-safe, export PDF/EPS/TIFF, for journal-ready scientific plots.
Seaborn
Statistical visualization. Scatter, box, violin, heatmaps, pair plots, regression, correlation matrices, KDE, faceted plots, for exploratory analysis and publication figures.
Shap
Model interpretability and explainability using SHAP (SHapley Additive exPlanations). Use this skill when explaining machine learning model predictions, computing feature importance, generating SHAP plots (waterfall, beeswarm, bar, scatter, force, heatmap), debugging models, analyzing model bias or fairness, comparing models, or implementing explainable AI. Works with tree-based models (XGBoost, LightGBM, Random Forest), deep learning (TensorFlow, PyTorch), linear models, and any black-box model
Pydeseq2
Differential gene expression analysis (Python DESeq2). Identify DE genes from bulk RNA-seq counts, Wald tests, FDR correction, volcano/MA plots, for RNA-seq analysis.
Query Writing
For writing and executing SQL queries - from simple single-table queries to complex multi-table JOINs and aggregations
Pydeseq2
Differential gene expression analysis (Python DESeq2). Identify DE genes from bulk RNA-seq counts, Wald tests, FDR correction, volcano/MA plots, for RNA-seq analysis.
Scientific Visualization
Meta-skill for publication-ready figures. Use when creating journal submission figures requiring multi-panel layouts, significance annotations, error bars, colorblind-safe palettes, and specific journal formatting (Nature, Science, Cell). Orchestrates matplotlib/seaborn/plotly with publication styles. For quick exploration use seaborn or plotly directly.