# Goals

> List and manage cross-session goals and milestones. Use for tracking multi-session work, viewing progress, or managing milestones.

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

---


# Goal Management

Manage goals and milestones that persist across Claude Code sessions.

**Command:** $ARGUMENTS

## Instructions

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

### No arguments or "list"
- Use `action="list"` to show all goals
- Display: title, status, progress %, priority
- 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
```