← Back to Skills Marketplace
pauldub

Codon

by pauldub · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
138
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install codon
Description
Organize agent memory as a navigable filesystem. Every piece of information gets a numbered address (10.03-client-name.md) — no search required. Zero depende...
README (SKILL.md)

Codon

Codon gives every memory an address. You navigate to it — you don't search for it.

Setup

If MEMORY/ does not exist in this workspace, run it once:

bash {baseDir}/init.sh

How to store

  1. Choose the right category from the taxonomy below
  2. Assign the next available ID in that category (check XX.00-index.md)
  3. Write to MEMORY/\x3Carea>/\x3CXX.YY-description>.md
  4. Add the ID to the category's index file

Example: new client contact → MEMORY/10-19-People/10.01-acme-jane-smith.md

How to recall

Navigate by ID prefix — don't search, locate:

  • "Who are my contacts?" → read files in MEMORY/10-19-People/
  • "What projects are active?" → read files in MEMORY/20-29-Projects/
  • "Find the Acme notes" → look for 10-19-People/10.XX-acme-*

Default taxonomy

Area Name Examples
10-19 People Contacts, clients, team members
20-29 Projects Active and past work
30-39 Resources Tools, docs, links, references
40-49 Work Tasks, decisions, meeting notes

Rules

  • Existing memory.md is preserved. Use MEMORY/ for all new entries.
  • If something fits two categories, prefer the more specific one. A person who is also a project contact goes in 10-19 People, not 20-29.
  • Index files (XX.00-index.md) track which IDs are taken. Always update them.
  • IDs are never reused, even after deletion.
Usage Guidance
This skill is small and appears safe: it will create a MEMORY/ directory and index files in your workspace when you run init.sh. Before installing or running it, back up any existing memory.md or existing MEMORY/ folder if you care about preserving content, and ensure the workspace is the intended target (the script computes the workspace as two directories up from the script location). There is no network activity or credential access. If you prefer, inspect init.sh yourself (it's short) before running it.
Capability Analysis
Type: OpenClaw Skill Name: codon Version: 1.0.0 The 'codon' skill is a memory organization tool that creates a structured filesystem (MEMORY/ directory) for an agent's workspace. The init.sh script safely creates directories and index files without any network calls or suspicious execution, and the SKILL.md provides clear, non-malicious instructions for the agent to manage information using a numbered taxonomy. No indicators of data exfiltration, unauthorized execution, or persistence were found.
Capability Assessment
Purpose & Capability
Name/description (organize agent memory as a filesystem) matches the delivered artifacts: a README, SKILL.md with usage, and a small init.sh that creates MEMORY/ directories and index files. There are no unrelated env vars, binaries, or remote downloads.
Instruction Scope
SKILL.md only instructs creating and using the local MEMORY/ hierarchy and to run init.sh if MEMORY/ is missing. The script only writes files under the workspace root and does not read or exfiltrate other files or environment variables. Minor note: SKILL.md uses a '{baseDir}' placeholder when showing how to run the script; that is a documentation placeholder and does not change behavior.
Install Mechanism
No install spec (instruction-only). The included init.sh is a small pure-bash initializer that creates directories and markdown index files. There are no downloads, package installs, or archive extraction steps.
Credentials
The skill requests no environment variables, credentials, or config paths. The init script only checks that the workspace root is writable before creating MEMORY/ and index files — this is proportional to its purpose.
Persistence & Privilege
always:false and user-invocable:true. The skill does not request permanent inclusion, does not modify other skills' configs, and only writes files under the workspace. It requires write permission to the workspace (checked before acting).
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install codon
  3. After installation, invoke the skill by name or use /codon
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of Codon: organize agent memory as a human-readable, navigable filesystem using numbered addresses (e.g., 10.03-client-name.md). - No dependencies required; information is stored in the MEMORY/ directory with a clear taxonomy for People, Projects, Resources, and Work. - Provides setup instructions and rules for creating, indexing, and recalling entries. - Ensures consistent updating of index files and prohibits ID reuse, preserving all new data separately from existing memory.md.
Metadata
Slug codon
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Codon?

Organize agent memory as a navigable filesystem. Every piece of information gets a numbered address (10.03-client-name.md) — no search required. Zero depende... It is an AI Agent Skill for Claude Code / OpenClaw, with 138 downloads so far.

How do I install Codon?

Run "/install codon" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Codon free?

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

Which platforms does Codon support?

Codon is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Codon?

It is built and maintained by pauldub (@pauldub); the current version is v1.0.0.

💬 Comments