Skip to content

happycatlabs/bradley-skills

v1.0.0

Personal agent skills for launching, inspecting, coordinating, and reviewing multi-agent development work.

GitHubOpen Website

Bradley Skills

Personal agent skills for launching, inspecting, coordinating, and reviewing multi-agent development work.

Skills

  • claude and codex: provider-specific subagent launchers
  • inspect-claude-session, inspect-codex-session, and inspect-cursor-session: local session transcript inspection
  • orchestrate: parallel multi-agent coordination
  • engineering-lead: interruptible portfolio, project, and domain coordination
  • agent-workspace: machine-configured durable Notion context for agent teams
  • agent-organization-directory: provider-neutral role/reporting directory and bounded local snapshots
  • material-transition-outbox: quiet-by-default, restart-safe reporting to exact directory bindings
  • workspace-coordinator: live reconciliation across workspace, tasks, trackers, repositories, CI, and shipping gates
  • dispatch: durable Codex worktree handoffs and delegation ledgers
  • monitor: PR-aware supervision and durable task closeout
  • codex-automation: local and remote Codex automation lifecycle management
  • brainstorm and consult: cross-agent exploration and consultation
  • critique: bounded review loops over existing work

Install

The supported install is the symlink loop into ~/.agents/skills/. Cursor loads that path as user-level skills. Do not vendor these files into an app repo.

git clone --depth 1 https://github.com/happycatlabs/bradley-skills.git \
  "$HOME/.local/share/bradley-skills"
mkdir -p "$HOME/.agents/skills"
cd "$HOME/.local/share/bradley-skills"
for skill in skills/*; do
  ln -sfn "$PWD/$skill" "$HOME/.agents/skills/$(basename "$skill")"
done

Idempotent refresh: git -C "$HOME/.local/share/bradley-skills" pull --ff-only, then rerun the loop.

Cursor desktop plugin (optional)

The "add plugins from folder" picker is a marketplace importer. It requires .cursor-plugin/marketplace.json in the selected folder. That file lives at the repo root. Select …/bradley-skills, not …/bradley-skills/skills.

Official local plugin test path from Cursor's docs:

mkdir -p "$HOME/.cursor/plugins/local"
cp -R "$HOME/.local/share/bradley-skills" \
  "$HOME/.cursor/plugins/local/bradley-skills"

Then Developer: Reload Window. Laptop ~/.cursor/skills and ~/.cursor/plugins/local do not sync to Cloud Agents.

Each skill is self-contained. Keep helper scripts and agents/openai.yaml metadata beside its SKILL.md when changing or distributing a skill.

Agent Workspace Setup

Each machine uses its own Agent Workspace destination. The repository contains no Notion workspace id, page id, user identity, or canonical workspace link. After installing the skills, create this machine-local profile:

{
  "schemaVersion": 1,
  "provider": "notion",
  "workspaceId": "<this-machine-notion-workspace-id>",
  "rootPageId": "<this-machine-agent-workspace-page-id>",
  "rootPageUrl": "<optional-canonical-notion-url>",
  "profileName": "<optional-local-name>"
}

The default profile is ${XDG_CONFIG_HOME:-$HOME/.config}/bradley-skills/agent-workspace.json. Set AGENT_WORKSPACE_PROFILE to an absolute path to use a different local profile. Keep the file outside repositories and readable only by the current user. The target agent runtime must separately expose and authenticate its Notion workspace, tracker, and live task-provider connectors. The skills stop before Notion operations when the configured workspace and exact root page cannot be verified.

To establish a project or domain lead on that machine, assign the session the role explicitly and invoke engineering-lead. It uses agent-workspace for durable context, workspace-coordinator for live reconciliation, dispatch for durable owners, monitor for observation, and orchestrate for bounded leaf work. Record stable role and project context beneath that machine's configured Agent Workspace; keep task activity, tickets, code, CI, and shipping truth with their native authorities.