Leadbay Skills

Team skills for Claude Code.

Install

git clone https://github.com/leadbay/skills.git ~/.leadbay-skills && \
  ~/.leadbay-skills/setup --with-knowledge

--with-knowledge clones the leadbay/knowledge mirror into ~/.leadbay/knowledge and installs Claude Code hooks (UserPromptSubmit for pre-task briefs, PreToolUse for hot-lane validation).

For developers who also use gstack and want one shared learnings store:

~/.leadbay-skills/setup --with-knowledge --gstack-interop

Update

~/.leadbay-skills/setup --update --with-knowledge

Each skill checks for updates on launch and notifies you.

Durable state — Conductor / worktree safety

All Leadbay state lives under $HOME/.leadbay/ so it's reachable from any Claude session in any workspace. Conductor uses git worktrees that get archived on workspace close — anything symlinked from $HOME/.leadbay/ into a worktree is silently lost when that workspace is archived.

Every setup invocation (including bare --update) self-heals:

• Detects symlinks under $HOME/.leadbay/ pointing into ephemeral paths (Conductor workspaces, /tmp, /var/folders).
• For dead symlinks: removes them. If it's the knowledge mirror, auto- re-clones from the canonical URL so you don't lose access.
• For live symlinks: verifies the worktree is clean and pushed, then replaces the symlink with a real clone (or rsync of contents). Refuses to proceed if there are uncommitted changes or unpushed commits — no silent data loss.

Never manually symlink $HOME/.leadbay/anything into a Conductor workspace path. The setup script will heal it on next run.

One-liner (install or update)

bash <(curl -s https://raw.githubusercontent.com/leadbay/skills/main/install.sh)

Add to a project

From the project root:

~/.leadbay-skills/setup --add-to-project

This appends skill routing rules to your CLAUDE.md.

Available Skills

Command	Description
/knowledge-find	Pre-task brief from the shared wiki (auto-fired by hook)
/knowledge-explore	Map a NEW workflow into the wiki via live tour (browser-based, NOT source-only)
/knowledge-question	Flag an open question into the questions/ folder
/learnings-from-pr	Pre-PR knowledge capture (invoke before git push)
/distill-style	Generate wiki/style/<repo>.md from dominant reviewer's PR comments
/diagnose	Deep diagnostic root cause analysis (evidence-based, no code changes)
/relentless	Overnight perfectionist loop (v2): artifact-file phase gates, banned-phrase grep, iteration-1 must deploy live, Milan Check requires file-path evidence
/org-retro	Org-wide engineering retro from GitHub + DBs
/sales-retro	Sales intelligence from PostHog analytics

Architecture

~/.leadbay-skills/
  VERSION                  # Update tracking
  setup                    # Install/update/project-inject
  install.sh               # One-liner: install or update
  CLAUDE.md                # Template for project routing
  bin/
    lb-skills-update-check # Cached GitHub version check
    lb-skills-config       # Shared key-value config (API keys, DB creds)
    lb-skills-assemble     # Build SKILL.md from .tmpl + shared fragments
  shared/                  # Reusable fragments composed into skills
    preamble.md            #   Update check
    voice.md               #   Builder voice guidelines
    discord-output.md      #   Discord formatting rules
    posthog.md             #   PostHog API setup
    db-setup.md            #   Database credential setup
  org-retro/
    SKILL.md.tmpl          # Template (edit this)
    SKILL.md               # Generated (do not edit)
  sales-retro/
    SKILL.md.tmpl          # Template (edit this)
    SKILL.md               # Generated (do not edit)
  config/                  # Local config (gitignored) — API keys, credentials

Adding a New Skill

1. Create my-skill/SKILL.md.tmpl with <!-- include: shared/preamble.md --> at the top
2. Use <!-- include: shared/filename.md --> for any shared sections
3. Target output under 1950 chars for Discord
4. Run bin/lb-skills-assemble to generate SKILL.md
5. Bump VERSION, commit both .tmpl and SKILL.md, push to main
6. Team runs ~/.leadbay-skills/setup --update