CtrlK
BlogDocsLog inGet started
Tessl Logo

jbaruch/nanoclaw-core

Core behavioral rules and skills for NanoClaw personal assistant agents. Always-on rules for communication, verification, memory, and formatting.

77

Quality

97%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

High

Do not use without reviewing

Overview
Quality
Evals
Security
Files

README.md

jbaruch/nanoclaw-core

tessl

Core behavioral rules and skills for NanoClaw personal assistant agents. Always-on rules for communication, verification, memory, and formatting.

Installation

tessl install jbaruch/nanoclaw-core

Rules

RuleScopeSummary
core-behavioralways-onBaseline conversational behavior — concise replies, no trailing summaries
telegram-protocolalways-onTelegram-channel formatting and reply conventions
language-matchingalways-onMatch the user's language; don't volunteer translations
default-silencealways-onSilent-on-no-news as the default; surface only what's actionable
temporal-awarenessalways-onConvert relative dates, respect timezones; compute past/future via now-vs-deadline, never eyeball it
ground-truthalways-onLive source > cached/recalled state; always verify before acting
read-full-contentalways-onRead full email/message bodies, never just snippets/previews
context-recoveryalways-onRecover from compaction by reading state, not by claiming lost context. Includes post-compaction skill-block disambiguation (history vs new tasks)
post-compaction-trustalways-onCompaction summaries are trusted state; do not re-derive what's already there
tone-matchingalways-onMirror the user's register; tone shifts signal mode shifts
query-size-limitsalways-onBounded SQL/API queries; never SELECT * on large tables
progress-updatesconditionalBrief updates at key moments; silence is not a failure

Skills

SkillDescription
query-historySearch messages.db by keyword and/or sender; companion to context-recovery
now-vs-deadlineDeterministically compare a deadline against the current instant; mandated path for temporal-awareness

Philosophy

  • Always on by default. 11 of the 12 rules are alwaysApply: true — the agent follows them without being prompted. progress-updates is conditional (alwaysApply: false + applyTo:), firing only when long-running background work is in play.
  • One concern per rule. Each file covers one topic so projects can override surgically without throwing out the whole tile.
  • Behavior, not domain. These are conversational and verification baselines — anything domain-specific (CFPs, calendar, email) lives in nanoclaw-admin.
  • Hint, not authority for state. Cached state is a recall hint; verify against the live source before acting on it (see ground-truth).

See CHANGELOG.md for version history.

CHANGELOG.md

pyrightconfig.json

README.md

requirements-dev.txt

tile.json