Agent skill

Catchup

by Avijit07x in Avijit07x/claude-db

Answer "where did I stop?" for this project. An agent skill from Avijit07x/claude-db.

Apache-2.0Auto-check passedAgent Workflows

Install Catchup

skills CLI
$ npx skills add Avijit07x/claude-db --skill catchup -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Avijit07x/claude-db catchup --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Avijit07x/claude-db.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/catchup .claude/skills/catchup && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
catchup
GitHub stars
231
Token cost
~489 tokens
SKILL.md length
286 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
Apache-2.0

At a glance

Answer "where did I stop?" for this project. An agent skill from Avijit07x/claude-db.

  • The user comes back to a project
  • SKILL.md covers Answer in three groups and Rules
  • Calls git
  • Starts a new chat

What it does

Catchup is an agent skill from Avijit07x/claude-db. Answer "where did I stop?" for this project. Gives three short groups, done, open and next, taken from the last chat, the recorded to-dos, the last handoff note and git. Use when the user comes back to a project, starts a new chat, or asks where they left off. It writes nothing.

Its SKILL.md is about 490 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows. It works with Git and Anthropic API. The repository describes itself as: Persistent memory for Claude Code. Bring your own database. The licence is Apache-2.0.

When your agent uses it

  • The user comes back to a project
  • Starts a new chat
  • Asks where they left off

Example prompts

  • “where did I stop?”
  • “/catchup”

What it can do on your machine

Read from SKILL.md and the folder at commit 9a6d829. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Catchup loads about 489 tokens when it runs. Until then it costs about 72 tokens; SKILL.md has 286 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~72
When it runs · the whole SKILL.md, loaded when a task matches
~489

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Avijit07x/claude-db at commit 9a6d829, republished under its Apache-2.0 licence (© Avijit07x). 286 words, ~489 tokens.

Download SKILL.mdSave it as .claude/skills/catchup/SKILL.md (or your agent's skills folder).
name
catchup
description
Answer "where did I stop?" for this project. Gives three short groups, done, open and next, taken from the last chat, the recorded to-dos, the last handoff note and git. Use when the user comes back to a project, starts a new chat, or asks where they left off. It writes nothing.

Where did I stop?

Run this from the project root:

bash
claude-db catchup

It prints what memory and git know about this project, in plain text. Some parts may be missing. A part with nothing in it is left out.

  • Last handoff is a note the user or a teammate saved on purpose. Trust it most.
  • Last chat is the newest recorded chat, with a few lines of the work done in it.
  • Still to do are to-dos found in earlier chats.
  • Not committed yet is recorded work that no commit has covered.
  • Git status and Recent commits are the live state of the repository.

If the output is Nothing recorded for this project yet., say exactly that and stop.

Answer in three groups

Reply with these three groups and nothing else. Keep each to a few short lines in plain words.

Done: what is finished. Take it from the last chat, the recent commits and the handoff's Done line.

Open: what is started but not finished. Take it from Not committed yet, Git status, the to-dos and the handoff's Open line.

Next: what to do first. Take it from the handoff's Next line, then from the to-dos.

Rules

  • Use only what the output shows. Do not read other files or search memory unless the user asks.
  • Mark anything you are unsure of with (guess). Never state a guess as a fact.
  • If there is no clear next step, write No clear next step found. Do not invent one.
  • Say how old the information is. Use the dates in the output, for example Last chat (Oct 6).
  • Do not save anything. Do not run any command that changes the repository.

Shipped with claude-db. It is replaced when claude-db updates.

© Avijit07x, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/catchup of Avijit07x/claude-db.

Open the folder on GitHubat commit 9a6d829

Compare with similar skills

Catchup next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Catchup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Catchup this skillAvijit07x/claude-db231—~489Automated safety check: PassApache-2.0
Helmor Bump Vendorsdohooo/helmor1.3k—~2.1kAutomated safety check: PassApache-2.0
Simplifytruffle-ai/dexto649—~1kAutomated safety check: PassCustom licence
Initrekal-dev/rekal-cli207—~567Automated safety check: PassApache-2.0
Omnigent Agent Builderomnigent-ai/omnigent11k—~2.1kAutomated safety check: PassApache-2.0
Lumen Doctorory/lumen305—~339Automated safety check: PassCustom licence

Similar skills

  • Helmor Bump Vendors

    dohooo/helmor

    Bump or upgrade the pinned versions of Helmor's bundled agent CLIs, SDKs, and supporting binaries — Claude Code + claude-agent-sdk (lockstep), Codex, Cursor SDK, OpenCode, Kimi, Pi, and gh / glab /…

    1.3k GitHub stars~2.1k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Simplify

    truffle-ai/dexto

    Review changed code for reuse, quality, and efficiency, then fix any issues found.

    649 GitHub stars~1k tokensUpdated 7 days ago
    Agent WorkflowsAuto-check passed
  • Init

    rekal-dev/rekal-cli

    Turn on Rekal memory in the current repository by running rekal init.

    207 GitHub stars~567 tokensUpdated 27 days ago
    Agent WorkflowsAuto-check passed
  • Omnigent Agent Builder

    omnigent-ai/omnigent

    Gives patterns for generating a minimal, valid Omnigent agent directory: the config.yaml fields, the right executor type, and the files each agent needs.

    11k GitHub stars~2.1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Lumen Doctor

    ory/lumen

    Checks the Lumen semantic search setup for the current project: embedding service reachability, index freshness and storage totals, with remediation notes.

    305 GitHub stars~339 tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Swarm

    guaardvark/guaardvark

    Launch and watch Guaardvark's Swarm Orchestrator: parallel coding agents, each in its own git worktree, working a markdown plan and merging back deterministically.

    251 GitHub stars~746 tokensUpdated today
    Agent WorkflowsAuto-check passed

More from Avijit07x/claude-db

  • Cdb Scan

    Avijit07x/claude-db

    Map this codebase into project memory — a code graph of every symbol and how they connect, plus a written profile of stack, layout, conventions and workflows.

    231 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Handoff

    Avijit07x/claude-db

    Write a short handoff note for the next chat or a teammate, with what is done, what is open and what comes next.

    231 GitHub stars~575 tokensUpdated today
    Auto-check passed

Questions about Catchup

What does Catchup do?

Answer "where did I stop?" for this project. An agent skill from Avijit07x/claude-db. Catchup is an agent skill from Avijit07x/claude-db." for this project.

When should I use Catchup?

Catchup fits situations like: the user comes back to a project; starts a new chat; asks where they left off.

How do I install Catchup in Claude Code?

Run `npx skills add Avijit07x/claude-db --skill catchup -a claude-code`. Or copy the skill folder (skills/catchup in Avijit07x/claude-db) into .claude/skills/catchup in your project. Claude Code loads it when a task matches its description.

How do I install Catchup in Codex?

Run `npx skills add Avijit07x/claude-db --skill catchup -a codex`. Or copy the skill folder (skills/catchup in Avijit07x/claude-db) into .agents/skills/catchup in your project. Codex loads it when a task matches its description.

Can I use Catchup in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Avijit07x/claude-db --skill catchup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/catchup, .gemini/skills/catchup, .github/skills/catchup and .opencode/skills/catchup in your project.

What does Catchup need to run?

Going by SKILL.md and its folder, Catchup needs the command-line tools its instructions call (git).

Does Catchup access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Catchup safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Catchup use?

Catchup is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Catchup use?

About 489 tokens (SKILL.md is roughly 2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Catchup?

Skills that share tags, products or a category with Catchup: Helmor Bump Vendors (dohooo/helmor, 1.3k stars), Simplify (truffle-ai/dexto, 649 stars), Init (rekal-dev/rekal-cli, 207 stars) and Omnigent Agent Builder (omnigent-ai/omnigent, 11k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Catchup?

Avijit07x (a GitHub user) maintains it in Avijit07x/claude-db, which has 231 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 7, 2026.

Source: Avijit07x/claude-db on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.