orient — Claude Code skill: what it does, how to install
The orient Claude Code skill points to the project map section relevant to a question about structure, ownership, rules, or next steps. It activates when someone asks where to look or how to proceed.
MIT ★ 26 updated 2026-11-16
npx skills add wrg32786/aigent-os --skill orient -a claude-codeWhat orient does
orient reads vault/concepts/MAP.md and directs the agent to the relevant section. Questions about locations map to Geography, ownership to Roster, and rules to Standing Rules. For routing between delegation and inline work, it points to the Compass entry on routing; build-pattern questions go to the Compass entry on Lego Arsenal Doctrine.
When the request gives no specific area, orient shares the MAP contents and asks which part is needed. The MAP is the source of truth, so the skill points to a section instead of retelling it.
What it helps with
- locate a component or resource in the project
- identify who owns a task
- find the rule that applies and choose a next step
Example prompts for the agent
- Orient me: where does this part of the project live?
- Who handles this task?
- I'm lost. Where should I start, and which rule applies?
How to install orient
1Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill orient -a claude-code2Manually: put the files in place
~/.claude/skills/orient/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/orient/
1Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill orient -a codex2Manually: put the files in place
.agents/skills/orient/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill orient -a cursor2Manually: put the files in place
.cursor/skills/orient/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install wrg32786/aigent-os skills/orient2Manually: put the files in place
.github/skills/orient/SKILL.md1Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill orient -a gemini-cli2Platform CLI
gemini skills install https://github.com/wrg32786/aigent-os --path skills/orientManually: put the files in place
.devin/skills/orient/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill orient -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about orient
How do I install orient in Claude Code?
Run npx skills add wrg32786/aigent-os --skill orient -a claude-code. The skill file is at ~/.claude/skills/orient/SKILL.md.
What does orient do?
It reads vault/concepts/MAP.md and points to the section relevant to questions about project locations, ownership, rules, or next steps. If the question does not name an area, it shares the MAP contents and asks which section is needed.
Which file does orient read?
It uses vault/concepts/MAP.md as the project map and source of answers.
Source text
SKILL.md · MIT
--- name: orient description: "Provide orientation. Use when asking to orient or needing an initial orientation." --- # orient When the user (or an agent) is confused about where something lives, who owns what, what the rules are, or what to do next, run this to load the canonical map. ## What it does Reads `vault/concepts/MAP.md`. If the user has named what they're confused about, surface only the section of the MAP most relevant to their question: - "where does X live" → Geography section - "who handles Y" → Roster section - "what's the rule for Z" → Standing Rules section - "whether to delegate or ship inline" → Compass row on routing - "what build pattern to use" → Compass row on Lego Arsenal Doctrine If the user has not named a confusion, give them the MAP table of contents and ask which area they need. ## Voice Tight. Don't restate the MAP — point to the section. The MAP is the source of truth. ## Triggered by Use on confusion patterns: "where does X live", "which repo", "who handles", "I'm lost", "where do I start", "how do I find", "what's the rule for".
© wrg32786 · MIT · wrg32786/aigent-os