OpenSkillIndex← back to search
claude-code

Awesome-omni-skill johnny-decimal

Johnny Decimal + PARA organization

install
source · Clone the upstream repo
git clone https://github.com/diegosouzapw/awesome-omni-skill
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/devops/johnny-decimal" ~/.claude/skills/diegosouzapw-awesome-omni-skill-johnny-decimal && rm -rf "$T"
manifest: skills/devops/johnny-decimal/SKILL.md
source content

Johnny Decimal + PARA Organization System

A hybrid system combining Johnny Decimal structure with PARA methodology.

Structure

AC.ID — Title
│
├── AC   = Area (10-99) + Category (X0-X9)
└── ID   = Unique identifier within category (01-99)

PARA Mapping

JD AreaPARAPurpose
10-19
ProjectsActive projects with a defined outcome
20-29
AreasOngoing responsibilities to maintain
30-39
ResourcesReference materials, topics of interest
90-99
ArchivesCompleted or inactive items
Inbox
—Items to process and organize

Project Numbering

Projects use a year-based ID format:

10.{YY}{NNN} — Project Title
     │  │
     │  └── NNN = Sequential number (001, 002, ...)
     └───── YY  = Year (25 for 2025)

Example: 

10.25001 — Website Redesign
(first project of 2025)

Rules

  • Categories subdivide areas (11, 12, 13...) — max 10 per area
  • IDs are unique items within a category (11.01, 11.02...)
  • Projects use 
    10.{YY}{NNN}
    format with year prefix
  • Keep one location per ID — no duplicates
  • Use descriptive titles after the number
  • Move completed projects to 90-99 Archives

File Naming Convention

Files inherit their prefix from the folder path:

{Category} - {Subcategory} - {Date} - {Description}.{ext}
    │            │             │           │
    │            │             │           └── Free-form description
    │            │             └── ISO date YYYY-MM-DD (optional)
    │            └── From parent folder name (e.g., "27.05 - Fiscalité" → "Fiscalité")
    └── From grandparent folder name (e.g., "27 - Finances" → "Finances")

Examples

Folder PathFile Name
27 - Finances/27.05 - Fiscalité/
Finances - Fiscalité - 2024-04-15 - Déclaration 2042.pdf
23 - Sport/23.01 - Tir à l'arc/
Sport - Tir à l'arc - 2024-09-14 - Licence FFTA.pdf
34 - Administratif/34.03 - Identité/
Administratif - Identité - Passeport.pdf

Rules

  • Separator: 
    -
    (space-dash-space)
  • Date: Optional, ISO format 
    YYYY-MM-DD
  • Description: Title Case, accents allowed
  • No date for reference documents (rules, templates)

Best Practices

  • Start simple — add categories only when needed
  • Use consistent naming conventions across all items
  • Prefer flat structures over deep nesting
  • Keep Inbox at zero — process and file items regularly

Index Location

The Johnny Decimal index is maintained in Apple Notes. Use the 

mcp_apple-notes
tools to search or consult the index when needed.