read-external
Read-only access to external repositories for cross-repo context. Use when you need to reference code, patterns, or documentation from other local repositories.
When & Why to Use This Skill
The read-external skill provides Claude with secure, read-only access to external local repositories, enabling comprehensive cross-repository context. It allows the agent to search, grep, and reference code, architectural patterns, and documentation across multiple projects, significantly enhancing developer productivity by eliminating the need to manually switch contexts or copy-paste code snippets.
Use Cases
- Code Pattern Consistency: Search external repositories to find and adapt established design patterns or utility functions, ensuring architectural alignment across different projects.
- Cross-Project Documentation Reference: Quickly retrieve technical specifications, API contracts, or README files from a centralized documentation repo while working on a specific implementation.
- Dependency Analysis: Use Grep and Glob to trace how specific libraries or modules are utilized in other local projects to understand best practices and edge cases.
- Architectural Auditing: Review the structure and configuration of related microservices to ensure new code adheres to organizational standards and naming conventions.
| name | read-external |
|---|---|
| description | Read-only access to external repositories for cross-repo context. Use when you need to reference code, patterns, or documentation from other local repositories. |
| allowed-tools | Read, Grep, Glob, Task |
Cross-Repository Read Access
This skill provides constrained read-only access to external repositories configured in additionalDirectories.
Available External Repos
External repositories are configured in .claude/settings.json under additionalDirectories. Check that file for the current list of available repos and their absolute paths.
| Repo | Purpose |
|---|---|
| unamentis-android | Android Client for UnaMentis |
Usage
Access is always active via additionalDirectories in settings.json. When you need external context, use the absolute path from the settings:
- Find files: Use
Globwith the repo's absolute path (e.g.,{repo_path}/**/*.kt) - Search content: Use
Grepwith pattern in the repo's absolute path - Read files: Use
Readwith absolute path from settings
Check .claude/settings.json for the exact paths configured on this machine.
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 for step-by-step instructions on adding new external repositories.