Will this skill delete my files or folders?

No. The skill is programmed to never delete folders automatically. It identifies issues and suggests actions, but requires explicit user confirmation for any structural changes.

What is a JDex file in this context?

A JDex is the authoritative index file in a Johnny.Decimal system that serves as the master list for all areas, categories, and IDs.

Can it handle +SUB index extensions?

Yes, it specifically checks for +SUB folders and compares them against their corresponding index files (e.g., Markdown files) to ensure every sub-item is documented.

Can I rebuild my index if it's completely out of sync?

Yes, the skill offers a regeneration feature that walks your filesystem and builds a new JDex while attempting to preserve existing metadata.

Where does the skill look for my Johnny.Decimal folders?

It searches common locations including iCloud Drive (Mobile Documents), ~/Documents/JD/, and ~/JD/, or you can specify a specific system code to audit.

Johnny.Decimal System Audit

Name: Johnny.Decimal System Audit
Author: ngerakines

byngerakines

•

Productivity & Workflow

Audits and synchronizes Johnny.Decimal systems by comparing index files against actual folder structures to ensure organizational consistency.

This skill provides a comprehensive auditing tool for users of the Johnny.Decimal information management system. It automatically locates JD roots, parses the JDex authoritative index, and snapshots the filesystem to identify discrepancies such as orphaned entries, undocumented folders, and name mismatches. By offering automated fixes and supporting +SUB index verification, it ensures your organizational system remains consistent, up-to-date, and structurally sound across multiple systems.

Key Features

01Cross-references JDex index entries with physical folder structures

02Supports +SUB index verification for deep organizational categories

03Identifies orphaned JDex entries and undocumented filesystem folders

043 GitHub stars

05Provides interactive fixes for synchronization and full JDex regeneration

06Detects and reconciles naming mismatches between index records and folder names

Use Cases

01Verifying that a Johnny.Decimal system is up to date after manual file moves or bulk imports

02Synchronizing a central index file with a newly created folder structure to maintain the 'source of truth'

03Identifying forgotten projects or unplanned IDs in a complex organizational hierarchy

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ngerakines/jd jd-jdex-audit

For use in Claude.ai and ChatGPT

Download Skill