Merge pull request #16 from entireio/codex/refresh-skills-readme

Changes

1

• MREADME.md+147/-123

Skills

Cross-agent skills and commands powered by Entire. Bring your Entire context to your agents with cross-agent skills.

Why This Exists

session-handoff

The Entire CLI captures the context behind your code changes: prompts, transcripts, Checkpoints, and the decisions that led to each change, alongside your git history. This repository packages agent-invokable workflows that teach coding agents how to use that context across development environments.

Reads Entire session metadata and helps move work from one agent to another without making the user reconstruct the context manually. Instead of looking up Entire commands yourself, you can ask in plain language and let your agent search prior work, inspect provenance, hand off session state, or turn repeated workflows into new skills.

Current behavior:

Install

• auto-detects the most recent session from .git/entire-sessions/
• reads the raw transcript at the path stored in session metadata
• produces a structured compaction summary (Task Overview, Current State, Important Discoveries, Next Steps, Context to Preserve) instead of dumping raw transcript lines
• surfaces unanswered questions from the previous agent for the user to answer
• supports checkpoint handoff via entire explain --checkpoint <id> --full --no-pager
• falls back to entire explain --checkpoint <id> --raw-transcript --no-pager if full output is unavailable
• resolves checkpoints from: local entire/checkpoints/v1 branch, .entire/settings.json checkpoint_remote, or nearby local clone
• filters sessions by agent name (e.g. "codex", "gemini") when mentioned

Install every skill with the skills CLI:

session-to-skill

npx skills add https://github.com/entireio/skills --all

Turns Entire session history into a focused reusable skill draft without making the user manually find, paste, or reconstruct old agent conversations. Install one skill:

Current behavior:

npx skills add https://github.com/entireio/skills --skill search

• asks what reusable behavior the user wants to extract before reading transcripts
• accepts an explicit session ID or checkpoint ID when the user already has one
• searches Entire history with entire search "<query>" --json when the user describes a repeated workflow
• expands selected checkpoints with entire explain --checkpoint <id> --full --no-pager
• reads active session metadata from .git/entire-sessions/<session-id>.json when needed
• extracts durable lessons such as repo conventions, validation commands, user corrections, required inputs, and behaviors to avoid
• drafts a focused SKILL.md instead of recapping the whole session
• asks before writing, installing, or overwriting a skill

Quick Start

[!NOTE]
These skills are most useful in codebases with real
Checkpoints and session history. The
richer the history, the more context your agent has to work with; in a new or
lightly captured repository, some workflows may have less to find or explain.

After installing, ask your agent for the workflow you want:

search past work for rate limiting

/explain src/auth.ts

what happened here: src/auth.ts:42-57

hand off this session

turn my release notes workflow into a skill

For a guided walkthrough, see the Skills tutorial.

What These Skills Help Agents Do

Included Skills

The current repository includes these skills. Each skill lives in skills/<skill-name>/SKILL.md.

search

Finds prior work in your Entire history by topic, repo, branch, author, or time window, so your agent can bring past context into the current task before making changes.

explain

Traces source code back to the original conversation where it was created. Use /explain with a function, file, or line of code to understand why it exists.

Current behavior:

• identifies the commit that introduced the code via git blame/log
• reads the session transcript via entire explain --no-pager --commit <sha>
• works with functions, files, and individual line changes
• reports clearly when code is untracked, uncommitted, or created outside an Entire session

what-happened

Explains what happened to a specific code block by tracing the latest change for a file line, range, or pasted snippet through git blame and Entire checkpoints. Starts from an exact file line, range, or pasted snippet and traces the latest change with git blame and Checkpoint context. Useful when reviewing a concrete block, debugging a regression, or asking why that block changed.

Current behavior:

session-handoff

• resolves file lines, ranges, or pasted snippets to exact line numbers
• asks for a concrete file line, range, or snippet before running provenance commands
• deduplicates commit and checkpoint lookups before running expensive transcript commands
• asks before expanding broad ranges with many unique commits
• summarizes entire explain output without dumping raw transcripts by default; raw transcript expansion is opt-in

Examples:

session-to-skill

• "tell me why this code is like that"
• "why does this code look like this?"
• "what happened here: src/auth.ts:42-57"
• "what happened at src/auth.ts:42"
• "what happened to this block?" plus a pasted snippet

Requirements

Searches Entire checkpoint history and transcripts to find prior work by topic, repo, branch, author, or time window. These skills are designed for repositories where Entire has captured useful history. Some workflows need:

Current behavior:

• the Entire CLI installed

• a git repository with Entire sessions, Checkpoints, or Checkpoint-backed commits

• entire login for workflows that search indexed history

• a GitHub origin and pushed, indexed Checkpoints for remote search results

• runs entire search "<query>" --json and summarizes the top matches

• supports filters: --repo, --branch, --author, --date, and inline query filters like author:<name>, date:week

• drills into a specific result with entire explain --checkpoint <id> --full --no-pager

• broadens searches progressively when initial results are empty (remove branch filter, widen date, simplify terms)

Installation

Install with skills CLI (universal, works with any Agent Skills-compatible tool):

npx skills add https://github.com/entireio/skills --all
# or a single skill:
npx skills add https://github.com/entireio/skills --skill session-handoff

Quick Start