# Send Principles to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "principles",
    "name": "Principles",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/andyhcwang/principles",
    "canonicalUrl": "https://clawhub.ai/andyhcwang/principles",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/principles",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=principles",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "principles",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-03T05:13:37.301Z",
      "expiresAt": "2026-05-10T05:13:37.301Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=principles",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=principles",
        "contentDisposition": "attachment; filename=\"principles-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "principles"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/principles"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/principles",
    "downloadUrl": "https://openagent3.xyz/downloads/principles",
    "agentUrl": "https://openagent3.xyz/skills/principles/agent",
    "manifestUrl": "https://openagent3.xyz/skills/principles/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/principles/agent.md"
  }
}
```
## Documentation

### Principles — 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

### /reflect or /reflect process

Process the inbox. Parse each thought, check for conflicts, route to the right file.

### /reflect inbox or /inbox

Add a raw thought to inbox.md. User just dumps text — you clean it up later during processing.

### /reflect wisdom

Show collected wisdom, optionally filtered by domain.

### /reflect principles

Show current principles across all domains.

### /reflect questions

Show open questions and their status.

### /reflect sources

Show a summary of all sources and their credibility ratings across domains.

### /reflect journal

Add a journal entry for today with timestamp.

### Processing Inbox (/reflect)

This 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



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 inbox.md after processing


Update principles/_index.md if new principles were added

### Wisdom Claims (wisdom/collected.md)

Claims 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 [proven] in one domain and [plausible] in another
Example: Alex Hormozi on business = [proven]. Alex Hormozi on health = [plausible].
Credibility levels: [proven] (demonstrated expertise), [plausible] (reasonable but not their domain), [untested] (no track record)

Domain format: category/aspect (e.g., health/sleep, business/pricing, productivity/focus)

### Principles (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)

Only 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)

Append-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 /inbox — I'll help you process and organize them with /reflect."
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: andyhcwang
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-03T05:13:37.301Z
- Expires at: 2026-05-10T05:13:37.301Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/principles)
- [Send to Agent page](https://openagent3.xyz/skills/principles/agent)
- [JSON manifest](https://openagent3.xyz/skills/principles/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/principles/agent.md)
- [Download page](https://openagent3.xyz/downloads/principles)