para-pkm
by @killerapp
Manage PARA-based personal knowledge management (PKM) systems using Projects, Areas, Resources, and Archives organization method. Use when users need to (1) Create a new PARA knowledge base, (2) Organize or reorganize existing knowledge bases into PARA structure, (3) Decide where content belongs in PARA (Projects vs Areas vs Resources vs Archives), (4) Create AI-friendly navigation files for knowledge bases, (5) Archive completed projects, (6) Validate PARA structure, or (7) Learn PARA organizat
clawhub install para-pkmπ About This Skill
name: para-pkm description: Manage PARA-based personal knowledge management (PKM) systems using Projects, Areas, Resources, and Archives organization method. Use when users need to (1) Create a new PARA knowledge base, (2) Organize or reorganize existing knowledge bases into PARA structure, (3) Decide where content belongs in PARA (Projects vs Areas vs Resources vs Archives), (4) Create AI-friendly navigation files for knowledge bases, (5) Archive completed projects, (6) Validate PARA structure, or (7) Learn PARA organizational patterns for specific use cases (developers, consultants, researchers, etc.)
PARA PKM
Organize by actionability, not topic. Projects/Areas/Resources/Archives for optimal AI navigation. Monthly review cadence.
Core Concepts
projects/stories/ for job applications_overview.md per area for context)Decision Tree
Has deadline/end state? β Projects
Ongoing responsibility? β Areas
Reference material? β Resources (default for uncertain items)
Completed/inactive? β Archives
Quick Start
1. python scripts/init_para_kb.py - Creates PARA + projects/stories/ + navigation
2. Identify projects (deadlines) β areas (ongoing) β resources (reference)
3. python scripts/generate_nav.py - Generate AI navigation
Scripts
| Script | Purpose | Usage |
|--------|---------|-------|
| init_para_kb.py | Scaffold new KB | |
| validate_para.py | Check structure, detect anti-patterns | [path] |
| archive_project.py | Archive with metadata (date, origin) | |
| generate_nav.py | Create AI nav (<100 lines) | [--kb-path] [--output] |
Templates
| Template | Purpose |
|----------|---------|
| assets/AGENTS.md.template | AI navigation index |
| assets/project.md.template | Project file structure |
| assets/area-overview.md.template | Area _overview.md format |
| assets/README.md.template | Knowledge base README |
Patterns by Role
projects/active/ features/bugs, areas/professional-development/, resources/coding-standards/projects/active/ deliverables + projects/stories/, areas/consulting/clients/, resources/templates/projects/active/ papers/grants, areas/research-program/, resources/literature-review/projects/active/ launches, areas/product-development/{active,research,graduated,legacy}/Complex Scenarios
Client = project + relationship: projects/active/client-x.md (deliverables) + areas/consulting/clients/client-x.md (relationship, billing)
Research lifecycle: areas/product-development/{research β graduated β active β legacy} with cross-references
Anti-Patterns
Content Lifecycle
Resources β Projects β Archives (research β active work β completed)
Areas β Archives (no longer responsible)
Projects βΊ Areas (goal becomes ongoing or vice versa)
AI Navigation & Success Tips
References
π‘ Examples
1. python scripts/init_para_kb.py - Creates PARA + projects/stories/ + navigation
2. Identify projects (deadlines) β areas (ongoing) β resources (reference)
3. python scripts/generate_nav.py - Generate AI navigation