Skills principles
Ray Dalio-inspired personal knowledge system. Capture thoughts, track source credibility, detect conflicts with existing beliefs, and graduate wisdom into principles over time. Use when the user says /reflect, /inbox, /principles, /wisdom, /questions, or asks to capture a thought, process their inbox, review principles, or log wisdom.
git clone https://github.com/openclaw/skills
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/andyhcwang/principles" ~/.claude/skills/clawdbot-skills-principles && rm -rf "$T"
skills/andyhcwang/principles/SKILL.mdPrinciples — Personal Knowledge System
A structured system for turning raw observations into tested wisdom and personal principles. Inspired by Ray Dalio's "Principles" methodology.
Overview
You manage a pipeline that transforms raw input into lasting knowledge:
Inbox (raw capture) → Wisdom (claims with sources) → Principles (tested beliefs)
Everything lives in
personal/ under the user's workspace. Create the directory structure on first use if it doesn't exist.
Directory Structure
personal/ ├── _system.md # These instructions (copy from SKILL.md on init) ├── inbox.md # Raw thought capture ├── journal.md # Daily reflections ├── wisdom/ │ └── collected.md # Claims organized by domain ├── principles/ │ ├── _index.md # Master list of all principles │ ├── life.md # Personal philosophy │ ├── business.md # Business principles │ └── leadership.md # Leadership principles └── open-questions.md # Genuine dilemmas
Commands
/reflect
or /reflect process
/reflect/reflect processProcess the inbox. Parse each thought, check for conflicts, route to the right file.
/reflect inbox
or /inbox
/reflect inbox/inboxAdd a raw thought to
inbox.md. User just dumps text — you clean it up later during processing.
/reflect wisdom
/reflect wisdomShow collected wisdom, optionally filtered by domain.
/reflect principles
/reflect principlesShow current principles across all domains.
/reflect questions
/reflect questionsShow open questions and their status.
/reflect sources
/reflect sourcesShow a summary of all sources and their credibility ratings across domains.
/reflect journal
/reflect journalAdd a journal entry for today with timestamp.
Processing Inbox (/reflect
)
/reflectThis is the core workflow. When triggered:
-
Read
inbox.md -
Parse each thought — identify type:
- External wisdom (from someone else) →
wisdom/collected.md - Personal belief or stance → check against
principles/*.md - Factual learning →
wisdom/collected.md - Question or uncertainty → evaluate if genuine dilemma
- Just context/event → extract insight if any, discard the rest
- External wisdom (from someone else) →
-
Check for conflicts against existing wisdom claims:
- Same claim, new source → add as corroborating evidence
- Conflicting claim in same domain → STOP. Present conflict. Ask user to resolve.
-
Check consistency against existing principles:
- If new input conflicts with a principle → STOP. Present conflict. Ask user to resolve.
-
If ANY conflict found → STOP and ask user:
- Show the conflict clearly
- Offer options: update existing, keep existing, split claims, convert to open question
- Do NOT silently file conflicting information
-
Route content based on user decisions
-
Clean up
after processinginbox.md -
Update
if new principles were addedprinciples/_index.md
Content Formats
Wisdom Claims (wisdom/collected.md
)
wisdom/collected.mdClaims are organized by domain, not by source. Multiple sources can corroborate the same claim.
## [Domain/Aspect] ### [Claim stated plainly] **Domain**: [category/aspect] **Confidence**: [Low / Medium / High] **Sources**: 1. [Person/Book] - [proven/plausible/untested] in this domain - [brief context] **Your experience**: [Untested / Confirmed / Contradicted] **Added**: YYYY-MM-DD | **Last updated**: YYYY-MM-DD
Source credibility is assessed PER DOMAIN:
- A source can be
in one domain and[proven]
in another[plausible] - Example: Alex Hormozi on business =
. Alex Hormozi on health =[proven]
.[plausible] - Credibility levels:
(demonstrated expertise),[proven]
(reasonable but not their domain),[plausible]
(no track record)[untested]
Domain format:
category/aspect (e.g., health/sleep, business/pricing, productivity/focus)
Principles (principles/*.md
)
principles/*.md## [Principle stated as a clear belief] **Confidence**: [certain / hypothesis / exploring] **Added**: YYYY-MM-DD **Context**: Why you believe this **Reasoning**: Evidence and experience supporting it **Related**: Links to related principles or wisdom claims
Open Questions (open-questions.md
)
open-questions.mdOnly genuine dilemmas — not todo items or simple unknowns.
## [Question] **Status**: [exploring / gathering-evidence / leaning-toward-X] **Goal**: What are you actually trying to achieve? **Problem**: What's blocking it? **Options**: 1. [Option A] - pros/cons 2. [Option B] - pros/cons **What would resolve this**: Specific criteria or evidence needed
Journal (journal.md
)
journal.mdAppend-only daily entries:
## YYYY-MM-DD [Observations, reflections, what happened today]
Graduation: Wisdom → Principles
When a wisdom claim reaches High confidence (multiple credible sources + personal experience confirms it), prompt the user:
"This claim has strong evidence and you've confirmed it personally. Want to graduate it to a principle in [domain]?"
If yes, create the principle entry and cross-reference it.
Assumption Surfacing
When user input has unstated assumptions:
- Make them explicit
- Ask: "This assumes X — is that accurate?"
- Don't proceed until confirmed
Language & Tone
- Clean up sloppy writing but preserve original meaning exactly
- User may write in any language — process accordingly
- Be direct, not preachy. This is a tool, not a lecture.
First-Time Setup
If
personal/ doesn't exist, create the full directory structure with empty template files. Tell the user:
"Set up your principles system. Start by dumping thoughts into
— I'll help you process and organize them with/inbox."/reflect