Best use case
johnny-decimal is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Johnny Decimal + PARA organization
Teams using johnny-decimal should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/johnny-decimal/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How johnny-decimal Compares
| Feature / Agent | johnny-decimal | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Johnny Decimal + PARA organization
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Johnny Decimal + PARA Organization System
A hybrid system combining [Johnny Decimal](https://johnnydecimal.com/) structure with [PARA](https://fortelabs.com/blog/para/) methodology.
## Structure
```
AC.ID — Title
│
├── AC = Area (10-99) + Category (X0-X9)
└── ID = Unique identifier within category (01-99)
```
## PARA Mapping
| JD Area | PARA | Purpose |
| ------- | --------- | --------------------------------------- |
| `10-19` | Projects | Active projects with a defined outcome |
| `20-29` | Areas | Ongoing responsibilities to maintain |
| `30-39` | Resources | Reference materials, topics of interest |
| `90-99` | Archives | Completed 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 Path | File 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.Related Skills
bgo
Automates the complete Blender build-go workflow, from building and packaging your extension/add-on to removing old versions, installing, enabling, and launching Blender for quick testing and iteration.
kubernetes-deployment
Deploy, manage, and scale applications on Kubernetes clusters using manifests, Helm charts, and autoscaling configurations.
kubernetes-deployer
Package and deploy applications to Kubernetes with Dockerfiles, Helm charts, and local Minikube deployment. Use when containerizing applications, creating Kubernetes manifests, setting up Helm charts, deploying to Minikube, or preparing cloud-ready configurations. Focuses on local-first deployment with stateless services.
kubernetes-architect
Expert Kubernetes architect specializing in cloud-native infrastructure, advanced GitOps workflows (ArgoCD/Flux), and enterprise container orchestration.
kubectl-skill
Execute and manage Kubernetes clusters via kubectl commands. Query resources, deploy applications, debug containers, manage configurations, and monitor cluster health. Use when working with Kubernetes clusters, containers, deployments, or pod diagnostics.
konto-deploy
Deploy and run Konto (personal finance dashboard) locally. Use when setting up a new Konto instance, troubleshooting installation, or helping users get started with Konto.
kind
Manage Kind (Kubernetes in Docker) clusters for local Kagenti development and testing.
Kind Local Kubernetes
This skill should be used when the user asks to "setup Kind", "local Kubernetes", "Kind cluster", "multi-node cluster", "Kubernetes development", "k8s local environment", or works with local Kubernetes clusters using Kind.
keycloak
Keycloak identity and access management. Use for SSO.
keycloak-expert
This skill should be used when the user asks to 'configure Keycloak', 'set up ABAC', 'create Keycloak realm', 'integrate Azure AD with Keycloak', 'implement authorization services', 'configure OIDC client', 'create Keycloak policies', 'set up UMA/RPT tokens', 'deploy Keycloak on OpenShift', 'integrate Spring Security with Keycloak', 'configure NextAuth.js with Keycloak', 'create protocol mappers', 'map Azure groups to roles', or needs guidance on Keycloak realm/client configuration, ABAC policies and permissions, identity provider federation, or Configuration as Code patterns.
karpathy
Coding principles for simplicity, clarity, and surgical precision. Use when you want Claude to think before coding, keep solutions minimal, make surgical changes, and define verifiable success criteria. Triggers on: karpathy mode, think before coding, simplicity first, surgical changes.
kamal-deploy
Expert-level Kamal deployment guidance for deploying containerized applications to any server. Use this skill when users ask about Kamal, container deployment, zero-downtime deployments, deploying Rails/web apps to VPS/cloud servers, kamal setup, kamal deploy, Docker deployment without Kubernetes, or deploying to Hetzner/DigitalOcean/AWS with Kamal. Also use when users mention DHH's deployment tool, 37signals deployment, or want an alternative to Heroku/Render/Vercel with self-hosted infrastructure.