# Track LeanOS Goal Progress

Goal state can drift when execution data lives across files, threads, and artifacts. This skill derives progress, gaps, trajectory, and recommended actions from the current LeanOS workspace.

## Install

```bash
npx skillstore add bellabe/goal-tracker
```

## Metadata

- - Slug: bellabe-goal-tracker
- - Version: 1.0.0
- - Author: BellaBe
- - GitHub username: BellaBe
- - License: MIT
- - Repository: https://github.com/BellaBe/lean-os/tree/main/.claude/skills/goal-tracker
- - Ref: main
- - Supported tools: Claude, Codex, Claude Code
- - Risk level: safe
- - Quality score: 80
- - Quality tier: silver
- - Public page: https://skillstore.pages.dev/skills/bellabe-goal-tracker
- - Manifest: https://skillstore.pages.dev/api/skills/bellabe-goal-tracker/manifest

## Capabilities

- Reads LeanOS goal files, linked threads, and artifacts to derive current goal state.
- Calculates active, completed, and blocked thread counts for each goal.
- Maps completed thread outcomes to success criteria and progress metrics.
- Projects goal trajectory against deadlines and target metrics.
- Identifies gaps and recommends actions based on goal autonomy settings.
- Updates goal state sections and produces progress reports when requested.

## Use Cases

- Review weekly progress: Generate a current status report with progress, risks, gaps, and next recommended actions.
- Update goals after thread completion: Apply completed thread outcomes to linked goal metrics and subgoal status.
- Detect execution gaps: Find stalled metrics, blocked subgoals, stale data, and missed trajectory early.

## Prompt Templates

### Check one goal

```
Use the goal-tracker skill to review my active goal named {goal_name}. Report status, progress, gaps, and the next recommended action.
```

### Create a goal snapshot

```
Use goal-tracker to scan all active LeanOS goals and produce a concise snapshot with risk level, progress, stale data, and recommended actions.
```

### Update after thread completion

```
A thread just reached Stage 6 learning. Use goal-tracker to update the linked goal state, subgoal status, metrics, and log entry.
```

### Analyze trajectory and interventions

```
Use goal-tracker to calculate trajectory for {goal_id}, compare projected completion to the deadline, identify the largest gaps, and propose interventions based on autonomy mode.
```

## Limitations

- Requires LeanOS goal and thread conventions to be present in the workspace.
- Depends on current and accurate thread data for reliable progress calculations.
- Does not change goal objectives or success criteria; that belongs to goal-setter.
- Should not create threads unless the goal autonomy setting allows it.

## Best Practices

- Keep goal files, thread metadata, and Stage 6 learning current before running reviews.
- Confirm autonomy settings before allowing the skill to create gap-closing threads.
- Run trajectory checks before planning sessions and after meaningful execution updates.

## Anti Patterns

- Do not use it to rewrite objectives, deadlines, or success criteria without goal-setter review.
- Do not mark a goal complete unless every success criterion has verified evidence.
- Do not rely on reports when linked threads are stale, missing, or contradictory.

## Security Audit

- - Safe to publish: true
- - Audited at: 2026-06-28T14:54:18.953\+00:00
- - Summary: Static analysis reported external commands, weak cryptography, and reconnaissance patterns, but review found markdown examples and ordinary prose only. No executable code, network calls, shell commands, cryptographic implementation, data exfiltration, or prompt injection attempt was found in SKILL.md.

## Stats

- - Views: 260
- - Downloads: 4
- - Favorites: 0
- - Popularity score: 0