# Read External

> Read-only access to external repositories for cross-repo context. Use when you need to reference code, patterns, or documentation from the iOS UnaMentis repository. Use when this capability is needed.

- Skill: `tomevault-io/read-external` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/read-external`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/read-external/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/read-external

---


# Cross-Repository Read Access

This skill provides constrained read-only access to external repositories configured in `additionalDirectories`.

## Available External Repos

| Repo | Path | Purpose |
|------|------|---------|
| unamentis-ios | /Users/cygoerdt/unamentis | iOS companion app - reference for feature parity, Swift patterns, and shared architecture |

## Usage

Access is always active via `additionalDirectories` in settings.json. When you need external context:

1. **Find files**: Use `Glob` with the repo's absolute path
   ```
   Glob: /Users/cygoerdt/unamentis/**/*.swift
   ```

2. **Search content**: Use `Grep` with pattern in the repo path
   ```
   Grep: "SessionManager" in /Users/cygoerdt/unamentis/
   ```

3. **Read files**: Use `Read` with absolute path
   ```
   Read: /Users/cygoerdt/unamentis/UnaMentis/Core/Session/SessionManager.swift
   ```

## Common Cross-Reference Tasks

When working on UnaMentis Android, use this skill to:

- **Feature parity checks**: Compare iOS implementation before building Android equivalent
- **Architecture patterns**: Reference how iOS handles audio, VAD, curriculum, etc.
- **API contracts**: Verify shared server API usage between platforms
- **UI/UX reference**: Check iOS UI patterns for consistency

## Constraints

When this skill is explicitly invoked with `/read-external`:
- ONLY Read, Grep, Glob, and Task tools are available
- No modifications to external repos (Edit/Write blocked)
- Reference and adapt code, don't copy wholesale

## Adding New Repositories

See [TEMPLATE.md](TEMPLATE.md) for step-by-step instructions on adding new external repositories.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/unamentis) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-15 -->