# gjalla-onboard

gjalla-onboard configures Gjalla telemetry, registers agent hooks and MCP, and ties recent coding sessions to git commits.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 107 installs · ★ 3 repo stars
- Author: gjalla
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gjalla/engineering/tree/HEAD/skills/gjalla-onboard/SKILL.md
- Updated: 2026-09-20
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/gjalla-onboard

## What it does

This skill prepares your repository for recording agent operations and memory. It ensures the Gjalla CLI exists on your machine using `pipx`, `uv tool`, or a `uvx` fallback. Then it runs `gjalla setup` to generate MCP settings, instructions, and hooks for detected tools like Claude Code or Codex.

It also analyzes recent work across the project. The skill scans local session transcripts from the past 7 days, matches them against git revisions, and tags each commit with categories like `feature` or `bug-fix` alongside recorded token numbers.

Authentication requires a quick manual confirmation. Because non-interactive calls cannot handle headless browser prompts, the skill requests a login link, displays the verification code, and checks completion via `gjalla auth status` before syncing data.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add gjalla/engineering --skill gjalla-onboard -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/gjalla-onboard/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/gjalla-onboard/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add gjalla/engineering --skill gjalla-onboard -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/gjalla-onboard/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add gjalla/engineering --skill gjalla-onboard -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/gjalla-onboard/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install gjalla/engineering skills/gjalla-onboard
```

2. **Manually: put the files in place**
- File: `.github/skills/gjalla-onboard/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add gjalla/engineering --skill gjalla-onboard -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/gjalla/engineering --path skills/gjalla-onboard
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/gjalla-onboard/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add gjalla/engineering --skill gjalla-onboard -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/gjalla/engineering/tree/HEAD/skills/gjalla-onboard/SKILL.md

## When to use it
- configure Gjalla MCP components and agent hooks inside git projects
- backfill commit records with session token stats from local logs
- handle non-interactive authentication for the Gjalla CLI
- categorize coding agent commits by task labels before uploading

## Example prompts
- Set up gjalla in this repo and backfill my past sessions
- Run gjalla-onboard to link this project and verify agent logs
- Onboard gjalla and calculate token spend for recent commits

## Similar
- [onboard](https://affpapa.org/en/nevibecode/commands/composio-community-onboard.md) — command · ★ 2003 repo stars
- [token-report](https://affpapa.org/en/nevibecode/skills/token-report.md) — skill · 749 installs
- [braintrust-analyze](https://affpapa.org/en/nevibecode/skills/braintrust-analyze.md) — skill · 490 installs
- [understand-onboard](https://affpapa.org/en/nevibecode/skills/understand-onboard.md) — skill · 4400 installs
- [01-usage](https://affpapa.org/en/nevibecode/skills/01-usage.md) — skill · ★ 571 repo stars
- [postmortem](https://affpapa.org/en/nevibecode/skills/sethgammon-postmortem.md) — skill · ★ 937 repo stars

From the same set: [gjalla/engineering](https://affpapa.org/en/nevibecode/by/gjalla/engineering.md) — 10 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
