# Goals

> This skill should be used when the user asks "show my goals", "what should I work on", "update goal progress", "create a goal", "add milestone", "complete milestone", "track progress", "manage milestones", or wants to track work across multiple sessions. Use when this capability is needed.

- Skill: `tomevault-io/goals` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/goals`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/goals/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/goals

---


# Goal Management

Manage goals and milestones that persist across Claude Code sessions.

**Command:** $ARGUMENTS

## Current Goals (Live)

!`mira tool goal '{"action":"list","limit":5}'`

<!-- If the above command fails or returns empty, call mcp__mira__goal with action="list" directly. -->

## Instructions

Parse the command and use the appropriate `mcp__mira__goal` action:

### No arguments or "list"
- The goals are already shown above
- Highlight in-progress and blocked goals

### "add <title>" or "create <title>"
- Use `action="create"` with the title
- Ask for description and priority if not provided
- Suggest adding milestones after creation

### "show <id>" or "progress <id>"
- Use `action="get"` with the goal_id
- Show full details including all milestones
- Display completion status for each milestone

### "milestone <goal_id> <title>"
- Use `action="add_milestone"`
- Add a new milestone to the specified goal
- Ask for weight if not provided (default: 1)

### "complete <milestone_id>"
- Use `action="complete_milestone"`
- Mark the milestone as done
- Show updated goal progress

### "done <goal_id>"
- Use `action="update"` with status="completed"
- Mark the entire goal as complete

## Example Usage

```
/mira:goals                           # List all goals
/mira:goals add Implement auth system # Create new goal
/mira:goals show 103                  # Show goal details
/mira:goals milestone 103 Add tests   # Add milestone
/mira:goals complete 17               # Complete milestone
```

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/conarylabs) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->