From 438686eac8062a0bd0eb10734cc9d255478694ef Mon Sep 17 00:00:00 2001 From: Michael Stock Date: Sat, 24 Oct 2026 05:31:31 +0000 Subject: [PATCH] feat(skills): add humanlayer source reference skill --- README.md | 2 ++ skills/humanlayer/SKILL.md | 63 ++++++++++++++++++++++++++++++++++++++ 2 files changed, 65 insertions(+) create mode 100644 skills/humanlayer/SKILL.md diff --git a/README.md b/README.md index 2ad6ba2..42e8a1a 100644 --- a/README.md +++ b/README.md @@ -154,6 +154,7 @@ Pi settings and models are copied by `make install`. Extensions, prompts, and th - `simplify` — code and comment simplification skill vendored from `bholmesdev/skills`, extended to cut over-engineering and needless defensiveness (explicit invocation only) - `unslop` — AI-writing cleanup and human-voice editing skill vendored from `cursor/plugins` commit `99559f2` (explicit invocation only) - `zmx` — guidance for managing persistent background terminal work +- `humanlayer` — read the HumanLayer monorepo from a local clone at `/data/workspace/code/oss/humanlayer`, with a map of its apps, contracts, and packages - `skill-doctor` — grade installed skills from real local sessions, then draft skill edits and a report; adapted from `warpdotdev/common-skills` with the collector rewritten on a bundled Letta trajectory pipeline (each run builds its own throwaway data root: `scripts/ingest.sh` pnpm-installs `@letta-ai/trajectory` with a bundled grok-build patch and normalizes recent sessions from every local agent into it) (explicit invocation only) - `tmux` — remote control tmux sessions through the active server, with an agent-neutral fallback socket when no server is running - `buildr-artifacts` — publish browser-viewable Buildr artifacts as static S3-hosted HTML/assets or stateful Vite apps served from Codexbox with `bld.run` URLs @@ -211,6 +212,7 @@ dotfiles/ ├── skills/ # custom agent skills │ ├── agent-browser/ # fast browser automation CLI for AI agents │ ├── before-and-after/ # GitHub PR screenshot and video formatting +│ ├── humanlayer/ # HumanLayer source reference from a local clone │ ├── reddit-search/ # Gemini-grounded Reddit search and thread resolution │ ├── ui-recording-timeline/ # interactive UI recording paint timelines │ └── writing-pr/ # PR title and body guidance diff --git a/skills/humanlayer/SKILL.md b/skills/humanlayer/SKILL.md new file mode 100644 index 0000000..ebf90d4 --- /dev/null +++ b/skills/humanlayer/SKILL.md @@ -0,0 +1,63 @@ +--- +name: humanlayer +description: Reference the HumanLayer source code (humanlayer/humanlayer monorepo) from a local clone. Use when you need to know how HumanLayer works or copy its patterns — its daemon, API, desktop/web app, CLI, Claude Code/OpenCode/Pi plugins, RPI skills, Electric sync, or docs — or when the user mentions HumanLayer, CodeLayer, or Riptide. +agents: [amp, claude, codex, pi] +--- + +# HumanLayer source reference + +A local clone of https://github.com/humanlayer/humanlayer lives at: + +``` +/data/workspace/code/oss/humanlayer +``` + +It is read-only reference material. Do not edit it or commit to it. + +## Before reading + +Pull so you read current code: + +```bash +git -C /data/workspace/code/oss/humanlayer pull --ff-only -q +``` + +If the directory is missing, clone it: + +```bash +git clone https://github.com/humanlayer/humanlayer.git /data/workspace/code/oss/humanlayer +``` + +Search with `rg` and `fd` from the repo root, and cite paths relative to it. +Start from the repo's own `AGENTS.md` and `README.md` for conventions. + +## Map + +HumanLayer runs coding agents (Claude Code, Codex, OpenCode, Pi) on your +machines and lets a team steer them from one place. "Riptide" is the codename +for the current product. Turborepo + Bun, TypeScript throughout, Effect in +newer code. + +| Path | What it is | +| --- | --- | +| `apps/riptide-daemon` | Daemon on each host that runs agent sessions; reacts to Postgres changes synced via Electric | +| `apps/riptide-api` | oRPC + Hono API (`src/orpc/api/...` per resource, `src/auth/`, `src/effects/services/`) | +| `contracts/riptide-api-contract` | oRPC contracts (API side and daemon side); OpenAPI generated from them | +| `contracts/riptide-electron-rpc` | Effect RPC contracts between Electron main and renderer | +| `apps/riptide-ui` | The app (TanStack Router + TanStack DB), web and inside desktop shells | +| `apps/riptide-electron`, `apps/riptide-native` | macOS desktop shells (Electron, Tauri) | +| `apps/riptide-electric-proxy` | Auth proxy in front of Electric SQL | +| `apps/riptide-cloud` | Admin web app (orgs, invites, settings) | +| `apps/cli` | `humanlayer` CLI: login (WorkOS device auth), daemon launch, `api` commands | +| `apps/riptide-claude-code-plugin`, `apps/riptide-opencode-plugin`, `apps/riptide-pi-extension` | Mirror agent sessions into HumanLayer | +| `apps/riptide-humanlayer-claude-plugin/skills` | Built-in skills: `orchestrate`, `teleport`, `show-me` | +| `apps/riptide-rpi-claude-plugin/skills` | Research-Plan-Implement skills (create/iterate research, plan, PRD, TDD, outline) | +| `apps/linear-cli` | Linear CLI | +| `apps/devstack` | Full local stack per worktree | +| `apps/docs` | User docs (guides, explanations, reference) — good for product behavior | +| `packages/db` | Drizzle Postgres schemas | +| `packages/sync`, `packages/streams`, `packages/y-durable-streams` | Electric/TanStack DB sync and durable streams | +| `packages/session-sdk-*` | Session SDK pieces (sessions, tools, diffs, artifacts, auth) | +| `packages/ai` | AI agents (summarizer, task generator, doc researcher) | +| `packages/ui` | shadcn/ui component library | +| `.claude/skills` | The HumanLayer team's own agent skills |