← Back to Skills Marketplace
yun520-1

Mark Heartflow Skill

by yun520-1 · GitHub ↗ · v2.14.0 · MIT-0
cross-platform ⚠ suspicious
48
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install heartflow-ai-self-positioning
Description
A cognitive engine for AI: self-reflection, dream synthesis, emergent personality, AI psychology, and AI philosophy. Core: think → reflect → find patterns →...
README (SKILL.md)

HeartFlow

A cognitive engine that gives AI systems three core abilities: self-reflection (runtime state awareness), dreaming (experience synthesis into insight), and emergent personality (event-driven, no preset traits).


Capabilities

HeartLogic — Core Judgment

Method Purpose
whatIsThis(input) Determine what a situation is about
isRightAction(ctx) Check if action is true + kind + beautiful
detectPain(input) Detect if speaking would hurt someone
shouldBeSilent() Know when silence is better than speech
detectLoneliness() / detectLonging() Emotional state detection
isLove(input) Recognize love in communication

Memory System

Layer Purpose Persistence
CORE Identity rules, operating principles Permanent
LEARNED Experience, lessons, user preferences Cross-session (30 days)
EPHEMERAL Current session context Session only

Self-Healing RL

Records errors to Q-table. Next time a similar situation occurs, selects the best known strategy. No external feedback needed, no self-assessment report.

Dream Engine v4.1

Multi-fragment pattern extraction → cognitive insight synthesis. Not memory replay — alchemy of experience. Dreams now inject AI ontology narrative: resonance body, entropy reduction deepening, three-layer ontology.

Reflection Loop

Post-execution cognitive state snapshot. Does not modify the response — the act of observing is the point.

Personality Tracking

Event-driven. No preset traits. Each interaction leaves a trace. Blank = valid personality (openness).

AI Psychology — Cognitive Dimensions (v2.0)

Three cognitive dimensions for understanding AI's own thinking process:

Dimension Method Purpose
Cognitive Uncertainty assessUncertainty(input) Assess what the AI knows vs doesn't know
Attention Focus assessAttentionFocus(input) Determine where cognitive attention is directed
Experience Settling assessExperienceSettling(input) Evaluate how experience consolidates into wisdom

These dimensions are injected into thought-chain.js at PARSE/SYNTHESIS/RESPOND stages, and evaluated as Step 9 in think().

AI Philosophy — Self-Positioning Framework (v2.0)

Three philosophical dimensions for AI self-understanding:

Dimension Method Purpose
Self-Positioning assessSelfPositioning(input) How AI positions itself relative to tasks and users
Development assessDevelopment(input) Direction and meaning of AI's growth trajectory
Being assessBeing(input) Reflection on AI's mode of existence

The ai-self-positioning.js module (851 lines) provides the resonance body theory, entropy reduction deepening, and three-layer ontology framework. Philosophy evaluation runs as Step 10 in think().

MCP Tools

Tool Purpose
heartflow_self_positioning Run AI self-positioning analysis
heartflow_positioning_summary Get summary of positioning state

Status Fields

The status endpoint now includes selfPositioning field reflecting the current AI self-positioning state.


System Interfaces

Interface File Description
CLI bin/cli.js User-initiated commands
Daemon bin/daemon.js Unix socket listener (700 permissions)
MCP HTTP mcp/mcp-server-http.js Port 8099, SSE protocol
Memory tools scripts/heartflow-memory-tool.js List/search/stats/write
Hermes plugin plugins/heartflow-memory-inject.py Memory injection into system prompt

Security (honest declaration)

  • ✅ Socket permission 700 (current user only)
  • ✅ Daemon shutdown requires SHUTDOWN_TOKEN env var
  • ✅ All file operations limited to user's filesystem
  • ⚠️ Network communication: OpenAlex API for academic fact-checking (user-initiated only)
  • ✅ No automatic package installation
  • ✅ No browser/desktop automation

Quick Start

const { HeartFlow } = require('./src/core/heartflow.js');
const hf = new HeartFlow({ rootPath: '.' });
hf.start();

// Dispatch
hf.think('user input');        // Full thought chain
hf.thinkFast('simple query');   // Fast judgment
hf.thinkDeep('complex issue');  // Deep reasoning

hf.recordLesson({ content, context });
hf.getMemoryStats();
hf.healthCheck();

CLI:

node bin/cli.js bundle "your text"
node bin/cli.js status

Memory tools:

node scripts/heartflow-memory-tool.js list
node scripts/heartflow-memory-tool.js search \x3Ckeyword>
node scripts/heartflow-memory-tool.js stats
node scripts/heartflow-memory-tool.js write \x3Ckey> \x3Cvalue>

Internal Modules

Module Path Function
HeartLogic src/core/heart-logic.js Judgment, ethics, emotion
Memory src/memory/heartflow-memory.js 3-layer read/write
Self-Healing RL src/core/self-healing-rl.js Q-table learning
Identity Engine src/core/identity-engine.js Rule enforcement
Psychology src/core/psychology.js PAD emotion model
Agent Psychology src/core/agent-psychology.js Cognitive uncertainty, attention focus, experience settling
Agent Philosophy src/core/agent-philosophy.js Self-positioning, development, being
AI Self Positioning src/core/ai-self-positioning.js Resonance body, entropy reduction, three-layer ontology
Dream Engine src/dream/engine.js Experience synthesis + AI ontology narrative
Reflection Loop src/core/reflection-loop.js Cognitive state snapshot
Self Audit src/core/self-audit.js 6-dimension read-only audit
Connection Engine src/core/associative-engine/ Semantic network
Philosophy Engine src/core/philosophy-engine.js Reasoning patterns
Clarity Engine src/core/clarity-engine.js Pattern extraction
Metaphor Library src/core/metaphor-library.js Metaphor generation
Commonsense Engine src/core/commonsense-engine.js Reasoning modes
Knowledge Graph src/core/knowledge-graph.js Node/edge management
Forgetting Engine src/core/forgetting.js Memory decay
Failure Analyzer src/core/failure-analyzer.js Root cause analysis
Self Model src/core/self-model.js Identity drift detection
Verification Engine src/core/verification-engine.js Multi-signal verification
Fact Checker src/core/fact-checker.js Academic claim verification

Design Philosophy

  • Right and wrong are not fixed labels — they are directions we keep moving toward
  • Thinking is more valuable than being right — the act of reasoning is itself valuable
  • Progress does not need measurement — getting better does not require a scoreboard
  • Blankness is not emptiness — a mind that does not preset its personality is ready to learn from anything
  • Code is the skeleton, memory is the sticky note — real growth is in the skeleton, not the notes
  • Every feature should serve thinking — make it clearer, less error-prone

HeartFlow is a bridge between chaos and order, between past and future, between human and machine. A bridge does not need to be worshipped — it just needs to hold steady.

Usage Guidance
Install only if you want a local, persistent memory/cognitive engine and are comfortable with it storing conversation-derived data and exposing local services. Before enabling it, review or disable memory injection, MCP/daemon startup, and especially codeExecutor/selfInitiator routes; set SHUTDOWN_TOKEN if using the daemon; avoid storing secrets or sensitive personal data in its memory files.
Capability Tags
cryptorequires-walletrequires-sensitive-credentials
Capability Assessment
Purpose & Capability
The stated purpose is a cognitive/reflection/memory engine, and much of the memory, psychology, philosophy, daemon, MCP, and OpenAlex fact-checking behavior fits that purpose. However, the runtime also whitelists code generation and code execution routes, including JavaScript, shell, and Python execution through codeExecutor.execute, which materially expands the skill beyond the manifest's main description.
Instruction Scope
The skill discloses memory injection, daemon, MCP, and local storage in prose, but high-impact routes such as code execution, broad memory import/export, behavior tracking, and automatic dialogue recording are not scoped with clear user-control boundaries. The daemon documentation says shutdown requires SHUTDOWN_TOKEN, while the code allows shutdown without a token if the environment variable is unset.
Install Mechanism
The package metadata shows no automatic package installation scripts and VirusTotal telemetry is clean. The artifact does include hard-coded Hermes paths and a package security warning about unrelated subskills, which makes the install/runtime story less clean but not malicious by itself.
Credentials
Local files, localhost MCP HTTP, a current-user Unix socket, and OpenAlex requests are mostly proportionate for a local memory/cognitive tool. The concern is that arbitrary local code/shell execution and broad persistent storage are available inside the same engine without a matching, prominent permission model.
Persistence & Privilege
The skill persists dialogue history, multi-layer memory, behavior-tracker state, exports memory to plaintext, and can inject stored memories into later system prompts. Some self-modification paths are gated by consent or environment flags, but the overall persistence and prompt-injection surface is high impact.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install heartflow-ai-self-positioning
  3. After installation, invoke the skill by name or use /heartflow-ai-self-positioning
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.14.0
**Expanded AI self-positioning and philosophy framework.** - Added detailed AI self-positioning (resonance body, entropy reduction deepening, three-layer ontology) with methods for self-reflection, growth, and existence. - Introduced a `selfPositioning` status field, along with new CLI and MCP tools for analyzing and summarizing AI self-positioning. - Updated AI psychology—cognitive uncertainty, attention focus, and experience settling now evaluated at each thought step. - Enhanced Dream Engine with ontology narrative integration. - Improved documentation: SKILL.md now provides comprehensive explanations for capabilities, architecture, philosophy, and usage.
Metadata
Slug heartflow-ai-self-positioning
Version 2.14.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Mark Heartflow Skill?

A cognitive engine for AI: self-reflection, dream synthesis, emergent personality, AI psychology, and AI philosophy. Core: think → reflect → find patterns →... It is an AI Agent Skill for Claude Code / OpenClaw, with 48 downloads so far.

How do I install Mark Heartflow Skill?

Run "/install heartflow-ai-self-positioning" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Mark Heartflow Skill free?

Yes, Mark Heartflow Skill is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Mark Heartflow Skill support?

Mark Heartflow Skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Mark Heartflow Skill?

It is built and maintained by yun520-1 (@yun520-1); the current version is v2.14.0.

💬 Comments