agentleFS
david-vrbadavid-vrba/claude-power-skills/skills/orient/SKILL.md

orient

Skill4 starsChanged 5 months agoMITView on GitHub

Drop into a project you haven't touched in a while and get oriented fast — what it is, the stack, entry points, recent activity, and where to start. For context-switching between many repos.

27 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use retro and ui-ux-pro-max.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • AWSSkill

    retro

    Conduct a retrospective on a coding session.

    Also in 3 projects that use this

  • StrayDragonSkill

    ui-ux-pro-max

    UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 8 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient.

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

2 rules. 0 are common, 2 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 25 edited versions we read keep these.

  • 2

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    If the user asked a specific question in the argument, answer that first, then give the rest briefly.

    line 23
  2. Distinctive:

    Keep it tight — this is orientation, not an audit.

    line 25

“Common” is measured: kept by at least 6 in 10 of the 25 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Rapidly map the CURRENT project so the user can start working without rereading everything. Assume they've been away for weeks. Be fast and concrete; do not modify anything.

Gather (parallelize where possible)

  1. What it is + stack — read the README and the manifest (package.json / pyproject.toml / go.mod / Cargo.toml / etc.). Identify framework, language, and package manager (check the lockfile).
  2. Recent activity — only if this is a git repo (else skip): git log --oneline -15 and git status (what was last worked on; anything uncommitted or stashed).
  3. Shape — top-level layout and the real entry points (main file, routes, app root, config). Name the 5–8 places that matter — don't dump the whole tree.
  4. Last known state — if the project keeps session notes or a resume checkpoint (e.g. a session_state_*.md or compact_checkpoint.md in a memory/notes folder), read it for what the user was last doing here.
  5. Loose ends — count TODO/FIXME/HACK markers; note whether tests and build/CI config exist.

Report — short and structured

  • What this is — 1–2 sentences + a one-line stack summary.
  • Where things stand — recent commits in plain words, uncommitted work, and the last session state.
  • Where to start — the key files/dirs mapped to what they do.
  • Loose ends — TODOs, missing/failing tests, anything half-done.

If the user asked a specific question in the argument, answer that first, then give the rest briefly.

Keep it tight — this is orientation, not an audit. If something looks broken, flag it; don't fix it unless asked.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.