johnny-decimal

Organize digital documents into Johnny Decimal areas, categories, and subcategories.

1|Updated Aug 1, 2013

Search Tags:#file organization #johnny decimal #document filing #folder naming #notes system #structured filing

Ready to run

npx skills add https://github.com/agude/dotfiles --skill johnny-decimal

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: johnny-decimal
Source: https://github.com/agude/dotfiles/tree/main/llm/skills/johnny-decimal
Command: npx skills add https://github.com/agude/dotfiles --skill johnny-decimal

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Johnny Decimal provides a disciplined, scalable way to organize digital documents so that every item has a single, discoverable location, reducing search time and misfiling.

Core Features & Use Cases

Enforced JD structure (Area → Category → Subcategory) for consistent filing
Built-in notes/index (JDex) to capture context about items
Clear naming conventions and tooling to browse, create, and move items
Use Case: Organize project docs, invoices, policies, and reference materials into predictable folders for quick retrieval

Quick Start

Create a new subcategory under an area (e.g., 21 Banks) and move a file there using the JD naming rules.

Frequently Asked Questions about johnny-decimal

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

What is the Johnny Decimal system for file organization?▼

The Johnny Decimal system is a structured file organization method that assigns every document a unique path using areas, categories, and subcategories. This ensures predictable folder naming and fast retrieval across personal and professional projects.

How do I organize digital documents so files are easy to find?▼

To organize digital documents for easy discovery, implement a structured filing system with enforced areas, categories, and subcategories. Using standardized folder naming and a notes index ensures every item has a single, discoverable location, reducing search time.

Can I use a structured folder naming system for my existing Documents directory?▼

Yes, you can apply a structured folder naming system directly to your existing Documents directory. It defines areas, categories, and subcategories, while scripting utilities help you create, move, and validate files into the new structure without losing data.

What is the best way to maintain context for filed documents?▼

The best way to maintain context for filed documents is using a built-in notes index, or JDex. This notes system captures background information about items within your structured filing setup, enabling fast filing and accurate retrieval later.

How do I validate my folder structure when organizing files?▼

You can validate your folder structure using built-in scripting utilities. These tools allow you to list, navigate, and validate your areas, categories, and subcategories to ensure your file organization remains compliant and predictable.

Does structured filing work for both personal and professional projects?▼

Yes, structured filing works for both personal and professional projects. By defining areas, categories, and subcategories with a standardized naming convention, the system scales to organize project docs, invoices, and reference materials across any context.