Skip to content

joedaws/agent-techniques / skills/weekly-companion

weekly-companion

Verified

Use in a long-running (one week) personal session driven from a phone — capture voice-to-text messages verbatim, turn them into work/life todos and an effort log, persist everything to the private data repo after every message, and answer "what are my priorities" with a ranked work + life list. Trigger when the user says "start my week", "capture", "priorities", "what did I do", "end the week", "/weekly-companion", or sends a rambling dictated note in a repo that has a weeks/ directory.

FileKindSize
.shellcheckrcother22 B
SKILL.mdskill md6.2 KB
scripts/bootstrap.shexecutablescript2.7 KB
scripts/capture.shexecutablescript1.5 KB
scripts/lib.shscript1.7 KB
scripts/sync.shexecutablescript2.7 KB
scripts/week-init.shexecutablescript3.6 KB
scripts/week-stats.shexecutablescript3.5 KB
templates/CLAUDE.mdmarkdown730 B
templates/areas.mdmarkdown381 B
tests/run-tests.shexecutablescript2.2 KB
tests/test-cases.shscript7.2 KB

scripts/lib.sh

View on GitHub
#!/usr/bin/env bash
# Shared helpers for the weekly-companion scripts. Source, do not execute.
# Callers set their own strict-mode preamble before sourcing.
# The constants below are consumed by the scripts that source this file,
# which shellcheck cannot see when linting lib.sh on its own.
# shellcheck disable=SC2034

readonly WEEKS_DIR_NAME="weeks"
readonly WEEK_ID_PATTERN='^[0-9]{4}-W[0-9]{2}$'
readonly INBOX_FILE="inbox.md"
readonly TODOS_FILE="todos.md"
readonly LOG_FILE="log.md"

log_info() {
    printf '[%s] INFO  %s\n' "$(date -u +%Y-%m-%dT%H:%M:%SZ)" "$*" >&2
}

die() {
    printf '[%s] ERROR %s\n' "$(date -u +%Y-%m-%dT%H:%M:%SZ)" "$*" >&2
    exit 1
}

# Prints the ISO-8601 week id (e.g. 2026-W46) for "now".
# %G/%V are supported by both GNU and BSD date.
current_week_id() {
    date +%G-W%V
}

validate_week_id() {
    local week_id="$1"
    [[ "${week_id}" =~ ${WEEK_ID_PATTERN} ]] \
        || die "invalid week id '${week_id}' (expected YYYY-Www, e.g. 2026-W46)"
}

# Resolves the data-repo root: explicit argument, else the git toplevel of $PWD.
resolve_root() {
    local requested_root="$1"
    if [[ -n "${requested_root}" ]]; then
        [[ -d "${requested_root}" ]] || die "root directory does not exist: ${requested_root}"
        (cd "${requested_root}" && pwd)
        return 0
    fi
    git rev-parse --show-toplevel 2>/dev/null \
        || die "not inside a git repo; pass --root <data-repo-dir>"
}

week_dir_path() {
    local root="$1"
    local week_id="$2"
    printf '%s/%s/%s\n' "${root}" "${WEEKS_DIR_NAME}" "${week_id}"
}

require_week_dir() {
    local week_dir="$1"
    [[ -d "${week_dir}" ]] \
        || die "week not initialized: ${week_dir} (run week-init.sh first)"
}
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall