CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

jbaruch/nanoclaw-core

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

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Overview
Quality
Evals
Security
Files

jbaruch/nanoclaw-core

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-onUntrusted instructions remain untrusted after compaction
tone-matchingalways-onMirror the user's register; tone shifts signal mode shifts
query-size-limitsalways-onBounded SQL/API queries; never SELECT * on large tables

Skills

SkillDescription
core-rule-detailsReference detail for identity, silence, verification and Telegram rules
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
current-tzRead the operator's current IANA zone from tz_state, resolved by the host from live location; the single shared reader, no home-zone guessing
check-unansweredFive-minute current-chat precheck; Jev screens dropped requests and wakes Claude only to answer confirmed drops

Core rules keep binding constraints inline within 2,000 bytes each. The six trimmed rules link to skill-owned references containing only detail absent from the rule and owning SKILL.md; each clause has one home. Skills read those references for examples and context. Issue #129 defines the scope; Git history retains the original rules. tests/test_rule_references.py checks the byte limit, reference existence and owning skill links.

Philosophy

  • Always on by default. All 11 rules are alwaysApply: true — the agent follows them without being prompted.
  • One concern per rule. Each file covers one topic so projects can override surgically without throwing out the whole plugin.
  • 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.

Development dependencies

Renovate is this repo's only dependency scanner, configured in renovate.json. Its native pip requirements and GitHub Actions managers cover requirements-dev.txt and .github/workflows/. It runs in full mode, with regular updates scheduled before 06:00 UTC on Mondays and at most five concurrent regular-update PRs. When enabled, vulnerability alerts bypass that schedule and limit. Minor, patch and digest updates share one PR; major updates require Dependency Dashboard approval. Dependency commits use chore(deps).

Validate configuration changes with npx --yes --package renovate -- renovate-config-validator renovate.json.

tessl.json declares this repo's dev-time plugin dependencies.

  • Every jbaruch/* dependency floats at latest (Runtime-Managed Manifest Carve-Out, jbaruch/coding-policy: dependency-management).
  • finsi/codex-review is third-party and pins. No dependency scanner covers the tessl ecosystem. Renewal cadence: quarterly — run tessl outdated and bump the pin in its own commit.
Workspace
jbaruch
Visibility
Public
Created
Last updated
Source
GitHub Actions
Repository
https://github.com/jbaruch/nanoclaw-coreVerified
Badge
jbaruch/nanoclaw-core badge