orient

Diagnose repository state and summarize the current working context.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/li3p/skills --skill orient-li3p
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: orient
Source: https://github.com/li3p/skills/tree/main/skills/orient
Command: npx skills add https://github.com/li3p/skills --skill orient-li3p

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Rebuild the current repository's working context after clearing context, opening an old branch, resuming work, or when the user asks what state the repo is in.

Core Features & Use Cases

  • Inspect git status, current branch, and upstream relation.
  • Review staged and unstaged diffs.
  • Review recent commits on the branch and on the base branch.
  • Identify changed files and read the files that explain the work.
  • Search modified files for TODO, FIXME, HACK, XXX, debug code, and incomplete tests.
  • Infer the most likely goal of the branch from changes and commit messages.

Quick Start

Run orient to load the current repository state and generate a concise working-state brief.

Frequently Asked Questions about orient

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I rebuild git context after switching to an old branch?

To rebuild git context after switching branches, inspect the repository status, diff staged changes, and review recent commits to infer the branch goal. This summarizes the current working state and identifies modified files containing TODO or FIXME markers.

What is the best way to summarize my current git repository state?

Summarizing your current git repository state involves analyzing branch relationships, unstaged diffs, and recent commit messages. This process identifies changed files and infers the likely development goal to generate a concise working-state brief.

How can I find incomplete work and debug code in my git diff?

To find incomplete work in your git diff, search modified files for notable markers like TODO, FIXME, HACK, and XXX. Reviewing staged and unstaged changes alongside recent commits helps identify incomplete tests and debug code.

How do I figure out what a git branch was working on?

To figure out what a git branch was working on, analyze the recent commit messages and changed files. Reading modified files and checking for debug code or markers allows you to infer the most likely goal of the branch.

Does this repository status summary work without any dependencies?

Yes, generating a repository status summary works without any dependencies. It directly inspects git status, branch upstream relations, and file diffs to diagnose the repository state and produce a working context brief.

When do I need to generate a working-state brief for a repository?

You need to generate a working-state brief when you have cleared context, opened an old branch, resumed work, or asked what state the repo is in. It diagnoses the repository state to quickly reorient you to the current work.