Project Skill
Create, track, and archive projects that bridge the gap between goals and daily tasks.
Usage
/project # Interactive: create new project or view status /project new # Create a new project /project status # Dashboard of all active projects /project archive <name> # Archive a completed project
Commands
/project or /project new
Creates a new project folder with a CLAUDE.md context file, interactively linked to a goal.
Steps:
-
Read Goals/1. Yearly Goals.md to list available goals
-
Ask user which goal this project supports (or "none" for standalone)
-
Ask for project name
-
Create Projects/<ProjectName>/CLAUDE.md with structure below
-
If linked to a goal, add [[Projects/<ProjectName>]] reference in the yearly goals file
Project CLAUDE.md Template:
Project: <Name>
Overview
[Brief description of what this project achieves]
Goal Link
Supports: [[1. Yearly Goals#<Goal Name>]]
Status
- Phase: Planning | Active | Review | Complete
- Progress: 0%
- Started: <date>
- Target: <date>
Key Decisions
- [Decision 1] - [Date] - [Rationale]
Next Actions
- [First concrete step]
- [Second step]
Notes
[Running log of updates, blockers, learnings]
/project status
Scans all Projects/*/CLAUDE.md files and displays a dashboard.
Steps:
-
Glob for Projects/*/CLAUDE.md
-
Read each file, extract: name, status/phase, progress%, goal linkage, next action
-
Display dashboard table
Output Format:
Project Dashboard
| Project | Phase | Progress | Goal | Next Action |
|---|---|---|---|---|
| ProjectA | Active | 60% | [[Goal 1]] | Review PR |
| ProjectB | Planning | 10% | [[Goal 3]] | Draft spec |
Summary
- Active projects: N
- Total progress (weighted): X%
- Projects without goal link: [list]
- Stalled projects (no update in 14+ days): [list]
/project archive <name>
Moves a completed project to the archives.
Steps:
-
Verify Projects/<name>/ exists
-
Confirm with user before archiving
-
Update project CLAUDE.md status to "Complete" and progress to 100%
-
Move folder: mv Projects/<name> Archives/Projects/<name>
-
Create Archives/Projects/ directory if it doesn't exist
-
Update any goal references to note completion
-
Report what was archived
Project Naming Conventions
-
Use PascalCase for folder names: Projects/LearnSpanish/
-
Keep names concise but descriptive
-
Avoid special characters
Cascade Integration
Projects are the critical middle layer:
Goals/1. Yearly Goals.md <- "What I want to achieve" | v Projects//CLAUDE.md <- "How I'll achieve it" (THIS SKILL) | v Daily Notes/.md <- "What I'm doing today"
When creating tasks in daily notes, reference the project:
- Draft API spec — [[Projects/MyApp/CLAUDE.md|MyApp]]
Task-Based Progress Tracking
New Project Tasks
TaskCreate: subject: "Read yearly goals" description: "Load goals for project linking" activeForm: "Reading yearly goals..."
TaskCreate: subject: "Create project structure" description: "Create folder and CLAUDE.md for new project" activeForm: "Creating project structure..."
TaskCreate: subject: "Link project to goal" description: "Add project reference to yearly goals file" activeForm: "Linking project to goal..."
Status Dashboard Tasks
TaskCreate: subject: "Scan project files" description: "Glob and read all Projects/*/CLAUDE.md files" activeForm: "Scanning project files..."
TaskCreate: subject: "Generate dashboard" description: "Compile status dashboard from project data" activeForm: "Generating project dashboard..."
Mark each task in_progress when starting, completed when done.
Integration
Works with:
-
/daily
-
Surface project next-actions in morning routine
-
/weekly
-
Project status in weekly review
-
/goal-tracking
-
Project progress feeds goal calculations
-
/onboard
-
Discover and load project context
-
/push
-
Commit project changes