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, installs Claude Code hooks (UserPromptSubmit, Stop, PreToolUse), and a 30-min sync timer (launchd on macOS, systemd on Linux).

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.

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 + journal (auto-fired by hook)
/knowledge-capture	Post-task journal write (auto-fired by hook)
/knowledge-explore	Bootstrap a new product surface (paired or code-only)
/knowledge-question	Flag an open question into the questions/ folder
/knowledge-sync	Push local journal to leadbay/knowledge
/knowledge-dream	Manual local consolidator preview
/diagnose	Deep diagnostic root cause analysis (evidence-based, no code changes)
/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