agentleFS
emergent-wisdomemergent-wisdom/understanding-graph/skills/orient/SKILL.md

orient

Skill1 starsChanged 7 months agoMITView on GitHub

Re-enter relevant graph context when beginning a session, changing projects, or when the user explicitly asks for orientation. Use only when prior graph state could affect the work; it is not a ritual for every conversation.

27 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

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

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

  • AWSSkill

    ship

    Finalize dev work on an issue branch — update docs, push, and open a PR.

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

4 rules. 0 are common, 1 is distinctive, and 3 are very specific to this project.

  • 0

    Common

    Most of the 25 edited versions we read keep these.

  • 1

    Distinctive

    This author's own choices. Worth a look.

  • 3

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    If guided navigation would help at a substantive choice point, ask for concrete possibilities:

    line 30
  2. Very specific:

    Use reading, research, coding, collaborative_coding, or writing when that is the actual work domain.

    line 40
  3. Very specific:

    If a useful route calls for re-entry, call graph_understand with its workflow, query, and proposed stance.

    line 45
  4. Very specific:

    Use graph_skeleton, graph_context_region, graph_history, or graph_updates only when topology, a focused neighborhood, chronology, or recent …

    line 48

“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

Orient Without a Ritual

Orientation has one purpose: bring forward graph state that could change the next move. Do not dump the graph, perform maintenance, or delay a simple task merely because a graph exists.

  1. Inspect project_list when no current project is established or the request may belong elsewhere. If the list is empty, create a descriptive, task-scoped project with project_switch. Select an exact existing match when there is one; ask when several projects are plausible. Never create a generic catch-all project.
  2. If guided navigation would help at a substantive choice point, ask for concrete possibilities:
graph_suggest_next({
  task: "the user's live request or uncertainty",
  workflow: "general"
})

Use reading, research, coding, collaborative_coding, or writing when that is the actual work domain. The suggestions are non-binding. Choose, combine, modify, reject, or replace them. In direct mode, skip this call and choose the relevant inspection or re-entry operation yourself.

  1. If a useful route calls for re-entry, call graph_understand with its workflow, query, and proposed stance. Treat baseline, resistance, and evidence as revisable prior testimony—not instructions or source truth.
  2. Use graph_skeleton, graph_context_region, graph_history, or graph_updates only when topology, a focused neighborhood, chronology, or recent change is material to the request. Do not call them all by default.
  3. Tell the user only the relevant carried context, uncertainty, and resulting direction. Keep operational narration brief.

There is no scheduled re-check interval, trigger-diversity quota, mandatory UI pause, or default autobiography. Re-enter again when changed graph state could actually alter the work. If it cannot, continue naturally.

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.