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/capture.sh

View on GitHub
#!/usr/bin/env bash
# Appends one raw capture (e.g. a dictated voice message) verbatim to the
# current week's inbox under a UTC timestamp heading. Text is read from stdin
# so multi-paragraph transcripts survive intact.
set -o errexit
set -o nounset
set -o pipefail
IFS=$'\n\t'

SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
readonly SCRIPT_DIR
# shellcheck source=lib.sh
source "${SCRIPT_DIR}/lib.sh"

usage() {
    printf 'Usage: %s [--root <data-repo>] [--week <YYYY-Www>] < capture.txt\n' "$(basename "$0")" >&2
}

main() {
    local requested_root=""
    local week_id=""
    while (($# > 0)); do
        case "$1" in
            --root) requested_root="${2:?--root needs a value}"; shift 2 ;;
            --week) week_id="${2:?--week needs a value}"; shift 2 ;;
            -h|--help) usage; exit 0 ;;
            *) usage; die "unknown argument: $1" ;;
        esac
    done
    [[ -n "${week_id}" ]] || week_id="$(current_week_id)"
    validate_week_id "${week_id}"

    local root week_dir capture_text
    root="$(resolve_root "${requested_root}")"
    week_dir="$(week_dir_path "${root}" "${week_id}")"
    require_week_dir "${week_dir}"

    capture_text="$(cat)"
    [[ -n "${capture_text//[[:space:]]/}" ]] || die "empty capture on stdin; nothing appended"

    printf '\n### %s\n\n%s\n' "$(date -u +%Y-%m-%dT%H:%MZ)" "${capture_text}" \
        >> "${week_dir}/${INBOX_FILE}"
    log_info "captured ${#capture_text} chars into ${week_id}/${INBOX_FILE}"
}

main "$@"
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