Skip to content
Skills Library
Personal productivity · Planning

orient

/orient

Orient a session at its start: read the start page, then say where we stand, what needs the person, and the next move, in three short lines. Use for /orient, at the start of a session, after a compaction, or when someone asks where are we, what is next, or what needs me.

Repository
foxrun ↗
Licence
MIT
Last repository change
26.10.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 26.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Orient a session at its start: read the start page, then say where we stand, what needs the person, and the next move, in three short lines. Use for /orient, at the start of a session, after a compaction, or when someone asks where are we, what is next, or what needs me.

Arguments

/orient [workspace]
Original author description

Orient a session at its start: read the start page, then say where we stand, what needs the person, and the next move, in three short lines. Use for /orient, at the start of a session, after a compaction, or when someone asks where are we, what is next, or what needs me.

How it works

  1. Steps
  2. Gotchas
Original SKILL.md headings · 24 lines, 276 words
SKILL.md preview
---
type: note
workspace: system
timestamp: 2026-10-26T14:25:00-04:00
name: orient
description: "Orient a session at its start: read the start page, then say where we stand, what needs the person, and the next move, in three short lines. Use for /orient, at the start of a session, after a compaction, or when someone asks where are we, what is next, or what needs me."
kind: knowledge
argument-hint: "[workspace]"
---

# orient

A session never opens cold. Orient reads the start page and turns it into three lines the person can act on.
The start page is working memory: state, lessons, what is new, and the last handoff.
A summary from a compaction is not a source. Read the start page again.

## Steps

1. **Read the start page.** Run `python3 ~/.foxrun/foxrun.py start --workspace <ws>`. Skip this only when a hook already printed it in this session and no compaction came after. Done when you have the start page text.
2. **Read what needs the person.** Run these on the tracker the start page names:
   `sqlite3 -readonly <tracker> "SELECT id,title,status FROM needs_me"` and
   `sqlite3 -readonly <tracker> "SELECT id,title,status FROM close_now"`.
   If the last handoff has Open Items, plan from them. Done when you have the list, or know it is empty.
3. **Pick the next move.** Use the handoff's next step first, then `SELECT id,title,status FROM next_step`. Pick one. Done when you can name one task and the first step.
4. **Say it in three lines.** Where we stand. What needs the person, with each id and its title. Your next move. Then start the move if it is yours. Done when the person has the three lines and you started, or you are waiting on them.

## Gotchas

- Run `date` before you write the time or the day.
- Give each id with its title, read from the tracker in this turn.
- Do not repeat the start page back. The person can read it. Give the signal.
- Outside `~/foxrun` and `~/.foxrun`, follow the repository's own rules; the start command does not apply.
Files in this package (2)
  • SKILL.md 2 KB
  • replays/three-lines.json 1 KB

Versions

RepositoryScoreLicence
This page · foxrun-ai/foxrun90MIT
restarter/lets-workflow100MIT
ramboz/jig100MIT
ramboz/jig100MIT
ramboz/jig100MIT
ramboz/jig100MIT
harnessprotocol/harness-kit100Apache-2.0
jcottam/agent-resources100MIT
nrdxp/predicate100MIT

Database snapshot: 13.11.2026 · package version 041fedb678cd (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100orient-in-codebase
    Learn an unfamiliar repository before changing it, including its real build and test commands, conventions and current health. Use this at the start of work in any repository you have not read in this session, or whenever you do not yet know how to run its tests, even if the task looks small.
  • 90hello
    Start a working session. Read where the last one stopped, bring the project and its setup to the latest state, clear finished work, and say what to do next. Use when someone says "hello", "hi", "good morning", "let's start", "let's get going", "where were we", "what's next", or…
  • 100smart-explore
    Explore a project or codebase using memory as a guide. Use when the user says "explore this project", "understand the codebase", "give me an overview", "catch me up on this project", "what's the state of X", "orient me", or starts working on a project that likely has prior…
  • 90bm-orient
    Orient Claude from Basic Memory before substantial repo work by reading active tasks, open decisions, recent checkpoints, and repo conventions. Use when resuming old work or when the user asks where things stand.
  • 100what
    Use when the user asks what is going on and needs a five-line summary of the session, branch, pull request, and ticket.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.