Obsidian Project Tracker

What it does

When your agent uses it

• Starting a new project tied to a yearly goal
• Seeing all active projects with phase and next action
• Archiving a finished project and updating its goal links
• Linking daily tasks to a project note

Example prompts

• “Create a project called LearnSpanish that supports my language goal.”
• “Show a status dashboard of all my active projects.”
• “Archive the MyApp project and note it as complete in my goals.”

Requirements

• An Obsidian vault with Goals and Projects folders
• Pre-approved tools (allowed-tools): Read, Write, Edit, Glob, Grep, Bash, TaskCreate, TaskUpdate, TaskList, TaskGet

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

1. 1Read Goals/1. Yearly Goals.md to list available goals
2. 2Ask user which goal this project supports (or "none" for standalone)
3. 3Ask for project name
4. 4Create Projects//CLAUDE.md with structure below
5. 5If linked to a goal, add [[Projects/]] reference in the yearly goals file

What it can do on your machine

Read from SKILL.md and the folder at commit ef1e4da. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Read
  • Write
  • Edit
  • Glob
  • Grep
  • Bash
  • TaskCreate
  • TaskUpdate
  • TaskList
  • TaskGet

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Obsidian Project Tracker loads about 1.1k tokens when it runs. Until then it costs about 44 tokens; SKILL.md has 263 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~44

When it runs · the whole SKILL.md, loaded when a task matches

~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

• NotePre-approves every shell command (allowed-tools: Bash)SKILL.md

  allowed-tools: Read, Write, Edit, Glob, Grep, Bash, TaskCreate, TaskUpdate, TaskList, TaskGet

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ballred/obsidian-claude-pkm at commit ef1e4da, republished under its MIT licence (© ballred). 263 words, ~1,125 tokens.

name

project

description

Create, track, and archive projects linked to goals. The bridge between goals and daily tasks. Use for project creation, status dashboards, and archiving completed work.

allowed-tools

Read, Write, Edit, Glob, Grep, Bash, TaskCreate, TaskUpdate, TaskList, TaskGet

model

sonnet

user-invocable

true

/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

# 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 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]

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"

- [ ] Draft API spec — [[Projects/MyApp/CLAUDE.md|MyApp]]

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..."

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..."

© ballred, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in vault-template/.claude/skills/project of ballred/obsidian-claude-pkm.

Open the folder on GitHubat commit ef1e4da