Lifegoals

Define goals, break them into milestones, and track progress step by step. Use when setting life goals, planning milestones, tracking long-term progress.

Security Scan

The skill is internally consistent: it is an offline, local CLI that stores logs under the user's home directory and its included script matches the SKILL.md description — no network, no extra credentials, and no surprising install steps.

Purpose & Capability

Name/description (life-goal tracking, milestone management) align with what the package requests and does. The script provides commands to record, view, export, and search goal entries and stores data locally; nothing in the files suggests unrelated capabilities (no cloud or third-party integrations).

Instruction Scope

Runtime instructions and the script are scoped to reading/writing local log files under ~/.local/share/lifegoals, printing status and exports, and basic text processing. There are no instructions to read unrelated system files, transmit data externally, or access credentials outside HOME. The skill does persist user-provided inputs to disk (expected for this purpose).

Install Mechanism

There is no install specification (instruction-only at registry level), but the package does include an executable script (scripts/script.sh). That script will create ~/.local/share/lifegoals and write logs when run — expected for a CLI tool, but users should note that files are created in their home directory when the script is executed.

Credentials

The skill requests no environment variables or credentials and only uses HOME to construct DATA_DIR. The level of environment access is minimal and proportional to the stated offline, local storage behavior.

Persistence & Privilege

always is false and the skill does not request elevated or persistent platform privileges. Its only persistent effect is creating and writing logs under the user's data directory (its own scope), which is appropriate for a local tracking tool.

Assessment

This skill appears coherent and local-only, but review a few practical points before installing/running: 1) The included script will create ~/.local/share/lifegoals and append user inputs to per-command log files and history.log — avoid entering secrets or passwords into the tool because exports include raw log contents. 2) The JSON export code does not escape user text safely and has formatting bugs; exported JSON may be malformed if entries contain quotes or newlines. 3) If you want to limit exposure, change DATA_DIR to a location you control and set appropriate filesystem permissions (chmod) on the directory. 4) Because the package includes an executable script, inspect it locally (you already have its contents) and run it only if you trust it. Overall the behavior matches the description and there are no network calls or unexpected credentials requested.

A command-line devtools toolkit for tracking and managing life goals. Check, validate, generate, format, lint, explain, convert, template, diff, preview, fix, and report on your goals — all from your terminal with persistent logging and full activity history.

Why Lifegoals?

• Works entirely offline — your personal goals never leave your machine
• No external dependencies or accounts needed
• Every action is timestamped and logged for full auditability
• Export your history to JSON, CSV, or plain text anytime
• Simple CLI interface with consistent command patterns

Commands

Command	Description
lifegoals check <input>	Check goal entries for completeness; view recent checks without args
lifegoals validate <input>	Validate goal structure, format, and feasibility
lifegoals generate <input>	Generate new goal ideas or milestone breakdowns
lifegoals format <input>	Format goal data for readability or presentation
lifegoals lint <input>	Lint goals for vague language or missing deadlines
lifegoals explain <input>	Explain a goal's structure and progress path
lifegoals convert <input>	Convert goal data between different formats
lifegoals template <input>	Create or apply goal templates for common objectives
lifegoals diff <input>	Diff two goal snapshots to track changes over time
lifegoals preview <input>	Preview goal output or milestone timeline
lifegoals fix <input>	Auto-fix common issues in goal definitions
lifegoals report <input>	Generate a progress report on your goals
lifegoals stats	Show summary statistics across all actions
lifegoals export <fmt>	Export all logs (formats: json, csv, txt)
lifegoals search <term>	Search across all log entries
lifegoals recent	Show the 20 most recent activity entries
lifegoals status	Health check — version, disk usage, entry count
lifegoals help	Show help with all available commands
lifegoals version	Print current version (v2.0.0)

Each data command (check, validate, generate, etc.) works in two modes:

• With arguments — logs the input with a timestamp and saves to its dedicated log file
• Without arguments — displays the 20 most recent entries from that command's log

Getting Started

# See all available commands
lifegoals help

# Check current system status
lifegoals status

# View statistics across all commands
lifegoals stats

Data Storage

All data is stored locally in ~/.local/share/lifegoals/. The directory structure:

• check.log, validate.log, generate.log, format.log, etc. — per-command log files
• history.log — unified activity log across all commands
• export.json, export.csv, export.txt — generated export files

Modify the DATA_DIR variable in script.sh to change the storage path.

Requirements

• Bash 4.0+ (uses set -euo pipefail)
• Standard Unix tools: date, wc, du, tail, grep, sed, cat
• Works on Linux and macOS
• No external packages or network access required

When to Use

1. Setting new life goals — use lifegoals generate to brainstorm objectives and lifegoals template to apply proven goal-setting frameworks like SMART goals
2. Breaking goals into milestones — run lifegoals check and lifegoals validate to ensure each goal has clear, actionable steps and deadlines
3. Tracking progress over time — use lifegoals diff to compare goal snapshots at different dates and lifegoals report to generate progress summaries
4. Reviewing and refining goals — run lifegoals lint to catch vague language, then lifegoals fix to tighten up weak goal definitions
5. Exporting goal data for sharing — use lifegoals export and lifegoals convert to transform your goal history into JSON, CSV, or text for journals, coaches, or planning tools

Examples

# Check a goal for completeness
lifegoals check "Learn Spanish to B2 level by December 2026"

# Validate a goal's structure
lifegoals validate "Run a marathon — target: sub-4-hours"

# Generate milestone ideas for a goal
lifegoals generate "Save $50k emergency fund"

# Lint a goal for vague language
lifegoals lint "Get healthier somehow"

# Format goal data for presentation
lifegoals format "Career: Get promoted to senior engineer"

# Create a goal from a template
lifegoals template "fitness-90-day-challenge"

# Diff two goal snapshots
lifegoals diff "Q1-goals vs Q2-goals"

# Generate a progress report
lifegoals report "2026-goals"

# View summary statistics
lifegoals stats

# Export all history as JSON
lifegoals export json

# Search for goals mentioning fitness
lifegoals search "fitness"

# View recent activity
lifegoals recent

Output

All commands output structured text to stdout. You can redirect output to a file:

lifegoals report annual-review > review.txt
lifegoals export csv

Configuration

The data directory defaults to ~/.local/share/lifegoals/. Modify the DATA_DIR variable at the top of script.sh to customize the storage path.

---

Powered by BytesAgain | bytesagain.com | [e-mail]