{
  "markdown": "# claude-handover\n\nA Claude Code skill for capturing and transferring project knowledge during team handovers.\n\nWhen someone goes on leave or transitions off a project, critical knowledge gets scattered across Slack threads, ticket boards, rough notes, and people's heads. This skill helps capture all of that in a structured way, and then helps the person picking up the project ramp up with proactive guidance.\n\n## Features\n\n- **Capture** project context through flexible ingestion (interview, file dumps, or both)\n- **Pickup** a handover with proactive guidance -- Claude surfaces what you need to know, suggests next actions, and connects dots from the handover context as you work\n- **Update** handovers bidirectionally -- the new person can add context so the original person can catch up when they return\n- **Share** via private GitHub repos with automatic sync, or just send the folder manually\n- **Staleness detection** -- warns when handover context might be outdated\n- **Contact preferences** -- respects whether the departing person wants to be reached or left alone\n\n## Installation\n\n### Claude Code (Plugin Marketplace)\n\nRegister the marketplace and install:\n\n```bash\n/plugin marketplace add fergalbittles/claude-handover\n/plugin install claude-handover@claude-handover\n```\n\n**Note:** After installing, start a new Claude Code session for the `/handover` commands to become available. In the meantime, you can use natural language — just say \"I want to pick up a handover\" and Claude will know what to do.\n\n### Manual Installation\n\nIf you prefer to install manually:\n\n```bash\nmkdir -p ~/.claude/skills/handover\ncurl -o ~/.claude/skills/handover/SKILL.md https://raw.githubusercontent.com/fergalbittles/claude-handover/main/plugins/claude-handover/skills/handover/SKILL.md\n```\n\n### Try the Example Project\n\nTo see what a completed handover looks like, copy the example project:\n\n```bash\nmkdir -p ~/.claude/handovers\ngit clone https://github.com/fergalbittles/claude-handover.git /tmp/claude-handover-example && \\\n  cp -r /tmp/claude-handover-example/plugins/claude-handover/handovers/example-project ~/.claude/handovers/example-project && \\\n  rm -rf /tmp/claude-handover-example\n```\n\nThen run `/handover pickup example-project` in Claude Code.\n\n## Commands\n\n```\n/handover capture          -- Start capturing a new project handover\n/handover projects         -- List all available handovers\n/handover pickup <project> -- Load a handover and get guided onboarding\n/handover update <project> -- Add new context to an existing handover\n/handover status <project> -- Quick dashboard for a project\n/handover help             -- Show this help text\n\nSharing (optional):\n/handover share <project>  -- Create a private GitHub repo and invite collaborators\n/handover clone <repo-url> -- Fetch a shared handover from GitHub\n/handover sync <project>   -- Pull latest changes from GitHub\n/handover publish <project> -- Push your updates to GitHub\n```\n\nYou can also just talk naturally -- \"I need to hand over my project\" or \"I'm picking up where Sarah left off\" and Claude will figure out what you need.\n\n## How It Works\n\n### For the person leaving\n\nRun `/handover capture` and Claude will walk you through it. You can:\n- **Interview mode** -- Claude asks questions one at a time\n- **Dump mode** -- drop files, paste text, share everything at once\n- **Mix** -- dump what you have, then Claude fills gaps with questions\n\nClaude adapts to your project's complexity -- quick dump for simple projects, deeper interview for complex ones.\n\n### For the person picking up\n\nRun `/handover pickup <project>` and Claude proactively presents:\n- Project summary and current status\n- Key people (with nicknames) and how to reach them\n- Priorities in order, with context\n- Active blockers and debugging context\n- Gotchas and tribal knowledge\n- Contact preferences for the person who left\n\nAs you work, Claude connects dots from the handover -- \"Btw, the handover mentioned this might happen, you should check...\"\n\n### Sharing\n\nAfter capturing, share via GitHub (recommended) or manually:\n\n**GitHub:** `/handover share <project>` creates a private repo and invites collaborators. Updates sync with `/handover publish` and `/handover sync`.\n\n**Manual:** Send the `~/.claude/handovers/<project>/` folder to whoever is picking up. They drop it in the same path and run `/handover pickup`.\n\n## File Structure\n\nHandover data lives in `~/.claude/handovers/<project-slug>/`:\n\n```\n~/.claude/handovers/my-project/\n  handover.yaml        # Structured metadata (people, channels, envs, contact prefs)\n  context.md           # Narrative context (priorities, blockers, gotchas, architecture)\n  updates/             # Timestamped update files (append-only)\n  resources/           # Raw files (PDFs, notes, configs) with index.yaml\n```\n\n## Customization\n\nThe skill is fully customizable -- edit `~/.claude/skills/handover/SKILL.md` to add functionality or adapt it to your team's needs.\n\n## License\n\nMIT\n",
  "bytes": 4973,
  "sha": "0955c1cd5a2d6c7c7c3e087d4427cc1f685efb2edb0c114aa693052bd4a8847d",
  "repo_slug": "fergalbittles/claude-handover",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_fergalbittles_claude_handover_claude_han_57d75092/readme"
}