Skill: bytesagain1/succession-plan (version 2.0.1)

--- version: "2.0.0" name: Succession Plan description: "Design succession plans with role mapping and transition roadmaps. Use when adding positions, listing candidates, prioritizing paths, planning transfers." author: BytesAgain homepage: https://bytesagain.com source: https://github.com/bytesagain/ai-skills --- # Succession Plan A lightweight, terminal-based productivity and task management tool for planning and tracking succession-related tasks. Add items, set priorities, view daily and weekly overviews, set reminders, and export your data — all from the command line with zero dependencies. ## Commands | Command | Description | |---------|-------------| | `succession-plan add <text>` | Add a new item to your task list (timestamped with today's date) | | `succession-plan list` | List all items currently in the data log | | `succession-plan done <item>` | Mark an item as completed | | `succession-plan priority <item> [level]` | Set priority for an item (default: medium) | | `succession-plan today` | Show items scheduled for today | | `succession-plan week` | Show a weekly overview of tasks | | `succession-plan remind <item> [when]` | Set a reminder for an item (default: tomorrow) | | `succession-plan stats` | Show total number of items tracked | | `succession-plan clear` | Clear all completed items | | `succession-plan export` | Export all data to stdout | | `succession-plan help` | Show help message with all available commands | | `succession-plan version` | Show current version (v2.0.0) | ## Data Storage - **Default location:** `~/.local/share/succession-plan/` - **Override:** Set the `SUCCESSION_PLAN_DIR` environment variable, or `XDG_DATA_HOME` to customize the base path - **Data file:** `data.log` — plain text, one item per line, prefixed with date - **History file:** `history.log` — timestamped log of every command executed - All data is stored locally on your machine. No cloud sync, no network calls. ## Requirements - Bash 4+ (uses `set -euo pipefail`) - Standard Unix utilities: `date`, `grep`, `wc`, `cat` - No external dependencies or API keys required ## When to Use 1. **Succession planning projects** — Track key positions, candidate assessments, and transition milestones as simple task items 2. **Daily planning** — Use `today` to see what's on your plate and `add` to capture new items as they arise throughout the day 3. **Priority management** — Set priority levels on tasks to keep focus on what matters most during busy transition periods 4. **Team handoff tracking** — Log knowledge transfer items, training sessions, and handoff checkpoints with reminders 5. **Quick task capture in automation** — Pipe items into `succession-plan add` from scripts or cron jobs to build a log of automated events ## Examples ```bash # Add a new succession planning item succession-plan add "Interview candidate for VP Engineering role" # Add multiple items for a transition roadmap succession-plan add "Document current processes for Q2 handoff" succession-plan add "Schedule shadowing sessions with successor" succession-plan add "Review knowledge base completeness" # Set priority on a critical item succession-plan priority "VP Engineering role" high # Check what's due today succession-plan today # View the weekly overview succession-plan week # Set a reminder for a follow-up succession-plan remind "Final candidate review" "next Monday" # List all tracked items succession-plan list # Check statistics succession-plan stats # Export data for reporting succession-plan export > succession-report.txt # Clear completed items when done succession-plan clear ``` ## How It Works Succession Plan uses a simple append-only log file (`data.log`) to store items. Each entry is prefixed with the date it was added. Every command you run is also logged to `history.log` with a timestamp, giving you full traceability of your planning activities. The tool follows Unix philosophy: it does one thing well, outputs plain text to stdout, and plays nicely with pipes and redirection. ## Tips - Combine with `grep` to filter items: `succession-plan list | grep "VP"` - Redirect export for backup: `succession-plan export > backup-$(date +%F).txt` - Use in CI/CD or cron to auto-log events: `echo "Deploy completed" | xargs succession-plan add` --- Powered by BytesAgain | bytesagain.com | [REDACTED_SECRET]

path: scripts/script.sh
content: #!/usr/bin/env bash
# succession-plan - Productivity and task management tool
set -euo pipefail
VERSION="2.0.0"
DATA_DIR="${SUCCESSION_PLAN_DIR:-${XDG_DATA_HOME:-$HOME/.local/share}/succession-plan}"
DB="$DATA_DIR/data.log"
mkdir -p "$DATA_DIR"

show_help() {
    cat << EOF
succession-plan v$VERSION

Productivity and task management tool

Usage: succession-plan <command> [args]

Commands:
  add                  Add item
  list                 List items
  done                 Mark done
  priority             Set priority
  today                Today view
  week                 Week view
  remind               Set reminder
  stats                Statistics
  clear                Clear completed
  export               Export
  help                 Show this help
  version              Show version

Data: \$DATA_DIR
EOF
}

_log() { echo "$(date '+%m-%d %H:%M') $1: $2" >> "$DATA_DIR/history.log"; }

cmd_add() {
    echo "$(date +%Y-%m-%d) $*" >> "$DB"; echo "  Added: $*"
    _log "add" "${1:-}"
}

cmd_list() {
    [ -f "$DB" ] && cat "$DB" || echo "  (empty)"
    _log "list" "${1:-}"
}

cmd_done() {
    echo "  Completed: $1"
    _log "done" "${1:-}"
}

cmd_priority() {
    echo "  $1 -> priority: ${2:-medium}"
    _log "priority" "${1:-}"
}

cmd_today() {
    echo "  Today $(date +%Y-%m-%d):"; grep "$(date +%Y-%m-%d)" "$DB" 2>/dev/null || echo "  Nothing scheduled"
    _log "today" "${1:-}"
}

cmd_week() {
    echo "  This week overview"
    _log "week" "${1:-}"
}

cmd_remind() {
    echo "  Reminder: $1 at ${2:-tomorrow}"
    _log "remind" "${1:-}"
}

cmd_stats() {
    echo "  Total: $(wc -l < "$DB" 2>/dev/null || echo 0)"
    _log "stats" "${1:-}"
}

cmd_clear() {
    echo "  Cleared completed items"
    _log "clear" "${1:-}"
}

cmd_export() {
    [ -f "$DB" ] && cat "$DB" || echo "No data"
    _log "export" "${1:-}"
}

case "${1:-help}" in
    add) shift; cmd_add "$@" ;;
    list) shift; cmd_list "$@" ;;
    done) shift; cmd_done "$@" ;;
    priority) shift; cmd_priority "$@" ;;
    today) shift; cmd_today "$@" ;;
    week) shift; cmd_week "$@" ;;
    remind) shift; cmd_remind "$@" ;;
    stats) shift; cmd_stats "$@" ;;
    clear) shift; cmd_clear "$@" ;;
    export) shift; cmd_export "$@" ;;
    help|-h) show_help ;;
    version|-v) echo "succession-plan v$VERSION" ;;
    *) echo "Unknown: $1"; show_help; exit 1 ;;
esac


path: scripts/succession.sh
content: #!/usr/bin/env bash
set -euo pipefail
CMD="${1:-help}"; shift 2>/dev/null || true; INPUT="$*"
python3 -c '
import sys
cmd=sys.argv[1] if len(sys.argv)>1 else "help"
inp=" ".join(sys.argv[2:])
if cmd=="plan":
    role=inp if inp else "Key Role"
    print("=" * 55)
    print("  Succession Plan: {}".format(role))
    print("=" * 55)
    for section in [("Current Holder","Name: ___  Tenure: ___  Retirement/departure: ___"),("Critical Knowledge","1. ___\n  2. ___\n  3. ___"),("Successor Candidates","Primary: ___ (Readiness: Now/6mo/1yr)\n  Secondary: ___ (Readiness: ___)\n  External: Consider if needed"),("Development Plan","1. Mentoring with current holder\n  2. Stretch assignments\n  3. Training courses\n  4. Cross-functional exposure"),("Transition Timeline","Month 1: Shadow and observe\n  Month 2-3: Co-lead responsibilities\n  Month 4-6: Lead with support\n  Month 7+: Fully independent")]:
        print("\n  {}:".format(section[0]))
        for line in section[1].split("\n"): print("    {}".format(line.strip()))
elif cmd=="matrix":
    print("  9-Box Talent Matrix:")
    print("  Performance ->")
    print("              Low         Med          High")
    print("  High   | Enigma     | Growth Star | Future Leader |")
    print("  Med    | Underperf  | Core Player | High Potential|")
    print("  Low    | Risk       | Average     | Specialist    |")
    print("  ^ Potential")
elif cmd=="help":
    print("Succession Planner\n  plan [role]   — Succession plan template\n  matrix         — 9-Box talent matrix")
else: print("Unknown: "+cmd)
print("\nPowered by BytesAgain | bytesagain.com")
' "$CMD" $INPUT

path: tips.md
content: # Succession Plan - tips.md
## Quick Reference


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (CRITICAL)