commit-invest

Persist investment discussions as structured blocks in an investment-notes git repository.

4|Updated May 5, 2026
One-click install
npx skills add https://github.com/mthli/skills --skill commit-invest
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: commit-invest
Source: https://github.com/mthli/skills/tree/main/commit-invest
Command: npx skills add https://github.com/mthli/skills --skill commit-invest

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It turns an investment discussion into structured, append-only notes that you can revisit later, instead of losing the reasoning in chat history.

Core Features & Use Cases

  • Structured Thesis/Observation/Macro/Lesson/Methodology: Converts your discussion into one or more standardized blocks with clear fields for distillation.
  • Append-only investment journals: Writes to per-ticker files (positions/<TICKER>.md) or shared files (macro.md, methodology.md, postmortems.md) without overwriting history.
  • Rich, distillation-friendly commits: Creates a commit message that preserves the full conversation log and includes block metadata for later mechanical mining by distill skills.
  • Guardrails for scoped repos: Ensures you run it only in the intended investment-notes git workflow (presence of expected repo structure/files).

Quick Start

Run commit-invest by explicitly telling Claude to commit this investment discussion (e.g., use /commit-invest) once you want the current views persisted to your investment-notes repo.

Frequently Asked Questions about commit-invest

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

FAQPage Schema
How do I save investment views as structured notes instead of losing them in chat history?

Save investment views by converting discussions into structured thesis, observation, macro, lesson, or methodology blocks. These blocks are written as append-only notes into a git repository, preserving your reasoning durably for later review instead of letting it disappear in chat logs.

How do I commit an investment thesis to a per-ticker tracking file?

Commit an investment thesis by triggering the save command during your discussion. The skill writes your crystallized view as an append-only entry into per-ticker files like positions/<TICKER>.md, ensuring your journal tracks individual assets without overwriting previous history.

What is the best way to journal macro views and methodology for investment decisions?

Journal macro views and methodology by appending structured blocks to shared files like macro.md and methodology.md. This keeps your investment decision capture organized in an append-only git repository, separating broad market context from specific asset tracking.

Do I need a specific git repository structure to write investment journals?

Yes, you need a scoped investment-notes git repository with the expected directory structure. The skill applies guardrails to ensure it only runs when the correct repo files are present, preventing accidental writes to unintended locations.

How does saving an investment discussion preserve the conversation log for future distillation?

Saving an investment discussion creates a rich commit message that preserves the full conversation log alongside block metadata. This distillation-friendly format allows downstream mining tools to mechanically extract insights from your thesis distillation later.

Can I capture investment lessons and postmortems in a structured notes repository?

Capture investment lessons and postmortems by appending structured methodology or lesson blocks to shared files like postmortems.md. The append-only git workflow ensures your investment journaling maintains a complete, historical record of your decision-making process.