← Sitemap

A skill for your AI agent

Johnny.Decimal Organizer

A place for everything. An agent that knows the rules. My personal Johnny.Decimal workflow, packaged as a downloadable skill to help keep your files and index organized.

Download skillInstall in Codex

Markdown instructions · No extra software to run

A little structure goes a long way.

Johnny.Decimal gives your information a simple numbered home: an area, a category, and an ID. Your JDex is the index that tells you what each ID means and where it lives. The same ID can connect files, notes, email, and links.

10-19 Projects           Area
└── 12 Creative work     Category
    └── 12.34 Short film ID
Learn the system at Johnny.Decimal

The workflow I use.

A skill is a set of instructions your agent can follow. This one teaches it to inspect your existing system, make the smallest coherent changes, and audit the result. It brings my organization rules; you bring your folders and JDex.

01

Find one good home.

File by purpose, reuse existing IDs, and use cross-references when something belongs in more than one context.

02

Keep the index in sync.

Check the JDex before assigning an ID, then record locations, related IDs, and decisions so you can find things again.

03

Leave a clearer system.

Use consistent names and dates, process inboxes, flag misplaced files, and report exactly what changed.

Make it part of your workflow.

  1. Download the ZIP and extract it.
  2. Move the johnny-decimal-organizer folder into ~/.agents/skills/ for personal use, or .agents/skills/ inside a project. Keep the whole skill folder together.
  3. Review references/rules.md and adapt it to your own system. Give your agent your JDex and the folders you want to work on.
  4. Invoke $johnny-decimal-organizer in Codex. If it doesn’t appear, restart Codex. Try an audit first:
Use $johnny-decimal-organizer to audit this folder against my JDex.
Show the proposed moves and renames before changing anything.

Includes the skill, reference rules, Codex display metadata, and a setup guide. Your agent uses its existing file or connected-service tools. The download includes no personal files or JDex.

Read the skillOfficial Codex skill documentation ↗

A personal adaptation by Jonathan Segal, based on Johnny.Decimal. Independently made; not an official Johnny.Decimal product.