offworld

Original：🇺🇸 English
Translated

Routes queries to Offworld reference files. Find and read per-repo references for dependency knowledge.

4installs
Sourceoscabriel/offworld-skill
Added on

NPX Install

npx skill4agent add oscabriel/offworld-skill offworld

Tags

Translated version includes tags in frontmatter
offworld-clidependency-referencescode-documentationrepo-navigation

SKILL.md Content

View Translation Comparison →

Offworld Reference Router

Use 
ow
to locate and read Offworld reference files for dependencies.

What This Does

  • Finds references for libraries and repos
  • Returns paths for reference files and local clones
  • Helps you read the right context fast

When to Use

  • You need docs or patterns for a dependency
  • You want the verified reference instead of web search
  • You are about to work inside a repo clone

Installation and Setup

If Offworld CLI or opencode is missing, read 
references/installation.md
in this skill directory and follow it.

Usage

Find a reference:
bash
ow map search <term>     # search by name or keyword
ow map show <repo>       # get info for specific repo
Get paths for tools:
bash
ow map show <repo> --ref   # reference file path (use with Read)
ow map show <repo> --path  # clone directory path
Example workflow:
bash
# 1. Find the repo
ow map search zod

# 2. Get reference path
ow map show colinhacks/zod --ref
# Output: /Users/.../.local/share/offworld/skill/offworld/references/colinhacks-zod.md

# 3. Read the reference with the path from step 2

If Reference Not Found

bash
ow pull <owner/repo>    # clone + generate reference
ow project init         # scan project deps, install references

Notes

  • Project map (
    .offworld/map.json
    ) takes precedence over global map when present
  • Reference files are markdown with API docs, patterns, best practices
  • Clone paths useful for exploring source code after reading reference

Additional Resources